Set up infrastructure for code documentation

[nicklafarge]

We need documentation that includes both a user guide and C++/Python code documentation. We need to decide

• Decide where this will be hosted? (Github Pages? readthedocs?)
• Set up web hook for documentation building
• Documentation for C++ (Sphinx?)
• Documentation for Python via pybind11 (Sphinx is supported)
• Documentation for Matlab functionality (???)
• Basic Organization
  • Getting started
  • Building from source
  • C++ Docs
  • Python Docs

[nicklafarge]

@rjpower4 What are your thoughts on hosting? I think readthedocs would be a good options - free for open source projects, integrates with CI, looks like it supports Sphinx, and is really simple to use. GitHub pages is of course another option, but then we have to decide on a template and there might be a bit more DIY-ness to it. What do you think?

[rjpower4]

Readthedocs works for me, though I have never used it before. I don't really have a preference here.

[nicklafarge]

Alright let's go with readthedocs for now then. I think I will need you to set up the webhook for it (I tried but I don't think I have permission to do that)

• Readthedocs GitHub Webhooks instructions: https://docs.readthedocs.io/en/stable/integrations.html#github
• Readthedocs page that I made to start playing around with
  https://readthedocs.org/projects/mbd-forest/
  • I will need to add you to the list of Maintainers here, so let me know when you create an account