Skip to content

Update Python frozen docs#2168

Merged
doug-walker merged 6 commits into
AcademySoftwareFoundation:mainfrom
remia:update-docs
Jun 17, 2025
Merged

Update Python frozen docs#2168
doug-walker merged 6 commits into
AcademySoftwareFoundation:mainfrom
remia:update-docs

Conversation

@remia
Copy link
Copy Markdown
Collaborator

@remia remia commented Jun 14, 2025

This is an attempt to fix the frozen doc errors in CI. I tried to fix a few warnings in the doc generation (there are still a lot, eg. undefined labels and cross references), and added a simple hack to remove the PyOpenColorIO.PyOpenColorIO duplication in the documentation generated type hints. I tried to use some autodoc settings to change these hints but no success, and it is not probably an ideal solution either. The same duplication might still come up again if we get rid of the frozen doc workflow, maybe we will need to rename the pybind11 module to something like Core (PyOpenColorIO.Core) or something else if there are no other ways?

There is an issue in the updated frozen docs where some of Config:: prefixes in the ref links disappears.

I'm not sure if someone else is looking at this issue and have come up with a better solution, in which case this can be ignored.

remia added 6 commits June 14, 2025 20:38
Signed-off-by: Rémi Achard <remiachard@gmail.com>
Signed-off-by: Rémi Achard <remiachard@gmail.com>
Signed-off-by: Rémi Achard <remiachard@gmail.com>
Signed-off-by: Rémi Achard <remiachard@gmail.com>
Signed-off-by: Rémi Achard <remiachard@gmail.com>
Signed-off-by: Rémi Achard <remiachard@gmail.com>
@doug-walker
Copy link
Copy Markdown
Collaborator

This is awesome Remi! Cuneyt was looking at it a little but didn't come up with anything and he just left for vacation for the next six weeks, so your fix is good timing.

@doug-walker doug-walker requested a review from michdolan June 14, 2025 20:28
Copy link
Copy Markdown
Collaborator

@doug-walker doug-walker left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Looks like this fixed the DOCS=ON CI runs.

Copy link
Copy Markdown
Collaborator

@zachlewis zachlewis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well done -- thanks Remi!

@doug-walker doug-walker merged commit b6d33f7 into AcademySoftwareFoundation:main Jun 17, 2025
25 checks passed
michaelHADSK pushed a commit to autodesk-forks/OpenColorIO that referenced this pull request Jul 24, 2025
* Remove excluded member

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Fix import errors

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Remove duplicated members

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Remove unused file

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Avoid package name duplication in Python documentation type hints

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Build frozen docs

Signed-off-by: Rémi Achard <remiachard@gmail.com>

---------

Signed-off-by: Rémi Achard <remiachard@gmail.com>
michaelHADSK pushed a commit to autodesk-forks/OpenColorIO that referenced this pull request Jul 24, 2025
* Remove excluded member

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Fix import errors

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Remove duplicated members

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Remove unused file

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Avoid package name duplication in Python documentation type hints

Signed-off-by: Rémi Achard <remiachard@gmail.com>

* Build frozen docs

Signed-off-by: Rémi Achard <remiachard@gmail.com>

---------

Signed-off-by: Rémi Achard <remiachard@gmail.com>
Signed-off-by: Michael Horsch <michael.horsch@autodesk.com>
@remia remia deleted the update-docs branch September 26, 2025 07:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants