API docs have general module documentation after submodules

[pekkaklarck]

API docs at http://robot-framework.readthedocs.org/ currently have general module docs after submodule docs. See, for example, http://robot-framework.readthedocs.org/en/2.9.2/autodoc/robot.result.html. This is annoying especially because we have useful examples in these general docs. For example, the previous module has examples at http://robot-framework.readthedocs.org/en/2.9.2/autodoc/robot.result.html#module-robot.result.

I think general docs were before submodule docs earlier but the order changed at some point. It turned out that it is easy to configure this by passing --module-first to sphinx-apidoc tool we use. The reason I haven't noticed it earlier is that it isn't currently documented: sphinx-doc/sphinx#2190

[pekkaklarck]

Yay, docs look much better now:
http://robot-framework.readthedocs.org/en/master/autodoc/robot.result.html

[pekkaklarck]

Related to this, should also have docs of the methods, attributes, etc. in source order, not in alphabetical order.