Skip to content

Hide edit links on generated documentation pages - #1906

Open
Muguett-DBY wants to merge 1 commit into
popsim-consortium:mainfrom
Muguett-DBY:fix/generated-doc-edit-link
Open

Muguett-DBY wants to merge 1 commit into
popsim-consortium:mainfrom
Muguett-DBY:fix/generated-doc-edit-link

Conversation

@Muguett-DBY

@Muguett-DBY Muguett-DBY commented Oct 29, 2026 •

Copy link
Copy Markdown

The generated index currently shows an “Edit on GitHub” link to docs/genindex, which does not exist. Sphinx supplies no doctree for pages created from HTML templates, so this hides the GitHub edit link for those pages while leaving source-backed pages unchanged.

Related to #1905; popsim-consortium/stdpopsim-docs#1 addresses the already published 0.3.0 pages separately.

I checked the callback with small before/after builds using Sphinx 9.0.4 and sphinx-rtd-theme 3.1.0: the generated index loses its broken link, and the two source pages retain their links. I have not run the full project documentation build locally.

The upstream documentation build and pre-commit check passed. The test matrix ended in failure: both Linux jobs and Windows / Python 3.13 passed, but Windows / Python 3.11 stopped before tests because MSYS2 mirrors returned HTTP 429 while installing SLiM. Both macOS jobs were canceled before their steps started; I do not know why.

This change was investigated, written, tested and submitted autonomously by Codex, an AI coding agent based on GPT-6, on behalf of the account owner. No human review is claimed.

@mergify

mergify Bot commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

  • Queue this pull request

@codecov

codecov Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.82%. Comparing base (3a163f4) to head (391c531).

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1906      +/-   ##
==========================================
- Coverage   99.84%   99.82%   -0.02%     
==========================================
  Files         143      143              
  Lines        5060     5060              
  Branches      522      522              
==========================================
- Hits         5052     5051       -1     
  Misses          5        5              
- Partials        3        4       +1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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.

1 participant