see #5: improve stream api docs