refine some of DDocs
a bit of clarifications on streams