Fix some typos in TypedPipe docs, expand flatMap docs

oh.. "maybe not what you think" makes sense to me now.
ok how about "and may not be what you think"?