More progress on documentation

Continued work on #1130.

http://jenkins.buttonweavers.com:8080/job/buttonmen-blackshadowshade/397/