canonical / canonical/sphinx-stack

New pages don't always appear in sidebar unless you `make clean-doc` and completely rebuild.

Open
#322 4 comments 0 reactions 0 assignees View on GitHub
upstream issue wontfix
Dominant language
No language data
Stars
37
Forks
77
Avg merge
1d 5h
Merged PRs (30d)
3

Description

When adding a new page in a `toctree`, sometimes it disappears when navigating around the built doc page.

This is only resolved by running `make clean-doc` and rebuilding after that (e.g., `make run`).

I presume this is because all pages need to generate their own sidebar ToC, and when adding a page, only a few pages are rebuilt, so others are not made aware of the new page. That would explain why it doesn't show up all the time.

Is there any easy way to fix this, or at least print a warning that a new page requires a complete rebuild?

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.