document policy around use of doxygen

[gonsie]

I've set up a repo for the user documentation which uses Doxygen to parse the header files and generate documentation. It requires that the header files be documented in a specific way. I need to write this down so that future developers can follow.