Add lots of comments, minor tweaks
Messing with ddox

See https://github.com/rejectedsoftware/ddox