As the docs expand we may want to migrate to some kind of industry standard method of documenting things. Things like:
We should eventually figure out which of these is best for our usecase (and ideally compatible with github pages) so we can migrate to it once we need it