Restructure Docs

All the contents of the references and glossery will come from the docs using html comments
(still looking at software to do this, I might have to hand roll my own, which would not be as pretty perhaps