I just added some new functionality to the API module (which should be deployed on api.drupal.org sometime soon), which allows us to use @section and @subsection tags in our API documentation, to break up long documentation into sections. Usage is documented here:
I know that we have a few topic/group pages in our API documentation that could really benefit from these new tags, and probably some really long function or hook pages as well. So this task entails:
a) Scan the existing topic/group pages and identify which ones could benefit from breaking up into sections. (And if anyone knows of any functions that need splitting up, they can be noted here too.)
b) Add the @section and @subsection tags as appropriate to the documentation identified in (a).
PASSED: [[SimpleTest]]: [MySQL] 56,343 pass(es). View
PASSED: [[SimpleTest]]: [MySQL] 56,412 pass(es). View