add upload example
docs about yielding control to downstream middleware