Do some cleanup of the DIY documentation

Kenneth Morelandrequested to merge
cleanup-diy into master

There were some malformed links that were giving LaTeX warnings about missing references. Also made some minor structural changes to make it more clear what each example was doing.

Merge request reports