Skip to content

Conversation

@vwheeler63
Copy link
Contributor

Purpose

To update ./doc/development/tutorials/extending_build.rst to match the updated code it uses in ./doc/development/tutorials/examples/todo.py.

It appears todo.py was previously updated shifting some lines down and this caused 5 code examples to be missing 1 or more lines at the end. This was fixed, as well as replacing an old function with a new function that parses directive content into nodes: parse_content_to_nodes().

Additionally, clarified when doctree-resolved event gets fired so make the example more understandable.

References

n/a

It appears `todo.py` was previously updated shifting some lines down
and this caused 5 code examples to be missing 1 or more lines at the end.
This was fixed, as well as replacing an old function with a new function
that parses directive content into nodes:  `parse_content_to_nodes()`.

Additionally, clarified when `doctree-resolved` event gets fired so make
the example more understandable.
@AA-Turner AA-Turner changed the title docs(extending_build.rst): update to match develoment/tutorials/example/todo.py Update extending_build.rst to match tutorials/example/todo.py May 20, 2025
@AA-Turner AA-Turner merged commit 39c8125 into sphinx-doc:master Jun 8, 2025
8 checks passed
@vwheeler63
Copy link
Contributor Author

Good solution (:pyobject:). Thank you, Adam! @AA-Turner

@vwheeler63 vwheeler63 deleted the docs/update_todo_tutorial_to_match_code branch June 9, 2025 16:04
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Jul 12, 2025
@AA-Turner AA-Turner added this to the 9.0.0 milestone Nov 25, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants