Move middleware/middleware.md to middleware.md. This should be the
canonical place where to document how middlewares should look and act.