Even more documentation and notes.

subtopics: