update docs

fix watch example
fix spelling
add note about using pipes