Skip to main content

How To Understand Wavelets

I got acquainted with developing against the Google Wave Preview last week, and I'll be doing more of it this week. There are still many gaps in the documentation and in the public understanding of what exactly is going on in a lot of cases. This post is halfway between an introduction to Wave development and a story of my personal hurdles in my first experiments working with it.

One of the first things you'll find in the Wave documentation is a diagram I have reproduced here. This diagram is wrong.


You're going to notice something when you look at this diagram and play around with Wave itself, the web client. You're going to realize you have no idea what the difference between a Wave and a Wavelet is. You don't seem to be able to even see the term "Wavelet" appear anywhere in the application! What's more, everything the API docs describe a Wavelet as is what the UI seems to call a Wave. This was really confusing to me and I know I'm not the only one confused.

It took me a little bit of time to get the perspective to understand what I missed. Correcting my diagram with that information produces this:


See what was missing there? The missing piece was the all-too-subtle connection, not between Wave and Wavelet, but between individual waves. The official documentation diagram places the waves in parallel and mislead me to look in the wrong mindset for the distinction between Wave and Wavelet in the presentation context.

So how does this pan out in the user interface of Wave? Private replies. A private reply to any blip/reply will create a new Wavelet with two participants: the creator of the blip you reply to and yourself. (Actually, you can create a single-participant child wavelet if you reply to yourself privately.)

I'd like to try some experiments and see if and how the interface would present setups like a child wavelet with completely different participants from the parent wavelet. I'm investigating the use of these as sort of hidden data channels in a Wave. For example, the Robot I am developing might store some auxiliary data about the waves it gets used in via private replies to itself. 

Now, since I'm probably going to be spending a good bit more time with Google Wave in the weeks to come, I expect to document more of the things I'll learn along the way. If you're interested, let me know what you're doing or thinking about doing with Wave.

Comments

Cory said…
Your diagrams are not public documents, so they don't come through as images.
Calvin Spealman said…
Thanks, Cory. Fixed.

That's what I get for thinking the publish feature from Google Docs to Google Blogger would actually work right for once.

Popular posts from this blog

On Pruning Your Passions

We live in a hobby-rich world. There is no shortage of pastimes to grow a passion for. There is a shortage of one thing: time to indulge those passions. If you're someone who pours your heart into that one thing that makes your life worthwhile, that's a great deal. But, what if you've got no shortage of interests that draw your attention and you realize you will never have the time for all of them?

If I look at all the things I'd love to do with my life as a rose bush I'm tending, I realize that careful pruning is essential for the best outcome. This is a hard lesson to learn, because it can mean cutting beautiful flowers and watching the petals fall to the ground to wither. It has to be done.

I have a full time job that takes a lot of my mental energy. I have a wife and a son and family time is very important in my house. I try to read more, and I want to keep up with new developments in my career, and I'm trying to make time for simple, intentional relaxing t…

The Insidiousness of The Slow Solution

In software development, slow solutions can be worse than no progress at all. I'll even say its usually worse and if you find yourself making slow progress on a problem, consider stopping while you're a head.

Its easy to see why fast progress is better: either you solve the problem or you prove a proposed solution wrong and find a better one. Even a total standstill in pushing forward on a task or a bug or a request can force you to seek out new information or a second opinion.

Slow solutions, on the other hand, is kind of sneaky. Its insidious. Slow solution is related the Sunk Cost Fallacy, but maybe worse. Slow solutions have you constantly dripping more of your time, energy, and hope into a path that's still unproven, constantly digging a hole. Slow solutions are deceptive, because they still do offer real progress. It is hard to justify abandoning it or trying another route, because it is "working", technically.

We tend to romanticize the late night hacking…

Why I Switched From Git to Microsoft OneDrive

I made the unexpected move with a string of recent projects to drop Git to sync between my different computers in favor of OneDrive, the file sync offering from Microsoft. Its like Dropbox, but "enterprise."

Feeling a little ashamed at what I previously would have scoffed at should I hear of it from another developer, I felt a little write up of the why and the experience could be a good idea. Now, I should emphasize that I'm not dropping Git for all my projects, just specific kinds of projects. I've been making this change in habit for projects that are just for me, not shared with anyone else. It has been especially helpful in projects I work on sporadically. More on why a little later.

So, what drove me away from Git, exactly?

On the smallest projects, like game jam hacks, I just wanted to code. I didn't want to think about revisions and commit messages. I didn't need branching or merges. I didn't even need to rollback to another version, ever. I just …