Thanks dstufft for the draft patch. Backport of 0e3690d230 from master
Reorganized topic document so it introduces concepts form simple to more complex. Moved reference parts to their own documents.