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.

PR-URL: #6947
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>