pipes: add documentation for pipes