Frozen Docs Update | Docs gen originates from header files, that gets parsed out, then when we build python docs we utilized that data to plugin and create the doc strings in the python api This works fine if building locally, but RTD doesn’t support cmake, so we needed to figure out a way to push the header data. So we freeze it locally for us in sphinx, it can grab that on RTD When we set this up, we didn’t have the python wheels. So now, we could pip install from RTD instead and generate the docs that way Much simpler, takes the whole frozen docs process out We could update the sphinx stuff on RTD to use the wheels first, and quietly stop using the frozen docs And then as a second step, we could clean up the frozen docs code and general docs generation steps And then third, we should change our RTD theme - maybe just use what OIIO is using? Michael will create an issue with these tasks, and then we can go from there
|