revised streams for clarity
small readability tweaks
updated readme