Fix some typos in TypedPipe docs, expand flatMap docs

maybe not be? or may not be?