add some notes on pipes