More clearly defined what is public API and what is private.
The public API page is now also sorted.
Finally, fixed a lot of linking between docstrings.