Add JavaDocs for end-user API

We should add a general method description before `@param`...

    Creates a flow builder for a flow that begins with a channel.