making docs render correctly WIP
Merge branch 'master' into docup
fix doc index rendering and generation and other display issues
trying to get BDD working (not fully there)
rebase to master
correct header parsing for more cases - ALL TEST PASS
Fix bad merge

good catch by @VictorLowther
revert name of barclamp

I kept the description since it's a better match than the v1 description.
revert rest of change
Merge pull request #142 from cloudedge/docup

Documentation Rendering Fixes (BDD passing 100%)