Closed jghibiki closed 5 years ago
They are generated via the module doc tags. sphinx has a script that scans the api and generates an autodoc skeleton. When the doc tags are updated, and the docs are rebuilt, the skeleton just says where each module should go. The api/
dir will need to get re-generated periodically if there are files added/removed. It is a trivial step.
Had offline conversation to discuss this. I was unclear before. My understanding is now as follows:
As it turns out, these are template files that are required by the generation of documentation, but are not themselves generated by that step. They will not change frequently; only when we need to update the styling/layout of the final documentation.
Creates a base docs setup in
sphinx
. Mostly just stubs for now. I will begin flushing them out once this is merged.