reorder documentation

- reorder documentation so it's grouped logically.
- add api docstring modules

Change-Id: I47e49634fe7d8bb16a51f3045e7fe53683d56d1a
Updated from global requirements

Change-Id: Ib667b02069ba68b4e33eae844caae6d33ba368c3