Doc fixes

Moved the docstring from Argument constructor to the class itself so that sphinx would show the constructor docs nicely instead (like `RequestParser`). Included clarifications about some of the arguments for #322.

Also made the `RequestParser` class appear before `Argument` in the docs.