📚 DOCS: Improve build process overview

This commit is contained in:
Chris Sewell
2020-08-20 22:37:37 +01:00
parent e4e9a0f4be
commit 5c744d8342

View File

@@ -179,8 +179,10 @@ type for that event::
11. event.env-get-updated(app, env)
11. event.env-check-consistency(app, env)
# The updated-docs list can be builder dependent, but generally includes all new/changed documents,
# plus any output from `env-get-updated`, and then all "parent" documents in the ToC tree
# For builders that output a single page, they are first joined into a single doctree before post-transforms/doctree-resolved
for docname in docnames:
for docname in updated-docs:
12. apply post-transforms (by priority): docutils.document -> docutils.document
13. event.doctree-resolved(app, doctree, docname)
- (for any reference node that fails to resolve) event.missing-reference(env, node, contnode)