doc: general improvements to stream.md copy

Majoring restructuring and update for streams doc.
This is the first step of multiple to updating and
correcting the streams documentation.