set up doxygen and display it on read the docs. there will be some configuration needed to tell doxygen to parse our code. We probably will need to make a pass over the headers to add more mark up, but the idea here is just to get something on the screen.
See also: https://www.doxygen.nl/index.html

the breathe project seems to a good starting point for displaying in rtd. if it turns out that there are major issues with breathe we can evaluate other options.
See also https://breathe.readthedocs.io/en/latest/