Document stream formats

From a comment on code review, @drebs asked for documentation and I agree, but we should do it after everything is in place to avoid spending time documenting moving ground.