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