improving stream documentation