more docs about alternative way to setup middleware
stub the changes for next revision
mark version for next release