Updated text generating the main API reference page.
Significant documentation improvements.
Some additional unit tests of concepts.