Restructure reference documentation

This commits sets the structure in place, moves the existing content
into its appropriate place, plus further updates to that content.

See gh-78

Author: rstoyanchev