Updated documentation of the Pipes module

Tony asked about the meaning behind behind what '>~' and '~>' do, so I changed
the headers for the 'Producer' and 'Consumer' sections to better explain how
the details of how they work rather than use vague words.