I think the example code is good, but it would be nice to be a bit clearer about what you are specifying in the example. I guess the only real confusing point is the withValue(1, "foo1") is obviously a (timestamp, value) pair, but only to people already in the know. Some clarification in a sentence preceeding this, or changing the "foo"s to "val/value" would be nice.