AcademySoftwareFoundation
Update API Docs Sphinx Theme
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.
@scoopxyz Hi am first time contributor for this repo, would like to add the documentation using Sphinx configuration. I made similar doc for another ASWF project https://github.com/AcademySoftwareFoundation/rawtoaces/issues/204. if it looks good i can proceed with creating similar doc for this project, please let me know for comments and feedback. Thanks
@pmady , this sounds interesting, thanks for offering to contribute! I have added this to the agenda for the TSC meeting on Monday and will report back.
@pmady, we discussed this at today's TSC meeting and the group has enthusiastically welcomed your offer to contribute. Please proceed! :)