I believe that the new DDOC is the correct course of action because:
* It's clarification on what the implementation did, so no breakage is done.
* For stream it makes perfect sense to reserve space relative to the current _state_ (be it offset in an array or something else) . The only stuff the writer is concerned with is how much can it write unlike containers that never lose the whole picture.