Documentation Rendering Fixes (BDD passing 100%)

These fixes to the documentation system address many of the long standing bugs that prevented reliable rendering of the index and topics.  It also includes a better master index page and updates to some docs for consistency.

I've tested it with actual booting and navigation.

BDD passes 100%
agreed - not a required change for this pull.  I will revert.