updating docs for middleware, adding history entries