AcademySoftwareFoundation / OpenColorIO

A color management framework for visual effects and animation.
https://opencolorio.org
BSD 3-Clause "New" or "Revised" License
1.76k stars 434 forks source link

Update API Docs Sphinx Theme #1872

Open scoopxyz opened 11 months ago

scoopxyz commented 11 months ago

As discussed in the TSC already, our present theme used in the API documentation is Press Theme, and it has unfortunately been marked as looking for a new maintainer. I'm sure someone will take up that request, but it won't be us.

Given the slightly uncertain future of the theme, and some visual oddities it can produce, its a good opportunity to revamp the theme to something like Furo which keeps a clean and modern aesthetic with much more community support for the project its self. We've also seen that fellow ASWF/O*IO project OpenImageIO has adopted it themselves.

In theory its a single line change in the Sphinx configuration, so may be a good first issue, but its not immediately clear if it will require larger changes to maintain readability across the docs.