docs(build): switch to extensionless URLs
Metadata
Current evaluation
Merged PR #820 as commit 571f1459, configuring Sphinx to use the dirhtml builder and publish documentation with clean, extensionless URLs.
Resolution: closed resolved
Reason: PR #820 was approved and merged as commit 571f1459. It added the dirhtml builder setting to .readthedocs.yaml, replacing .html URLs with directory-style URLs.
Evaluated by: mr-cal-bot
No scores available.
Issue body
This should force Sphinx to use the dirhtml builder, which will enforce clean
URLs instead of .html
- [X] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)?
---
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Merged PR #820 as commit 571f1459, configuring Sphinx to use the dirhtml builder and publish documentation with clean, extensionless URLs. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged documentation update forcing Sphinx’s dirhtml builder to produce extensionless URLs instead of .html pages (canonical/rockcraft#820). | |
| qwen/qwen3.6-35b-a3b | — | — | Merged a pull request that switches to extensionless URLs by forcing Sphinx to use the dirhtml builder for clean URLs. The change was approved by reviewers and passed CI checks. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged external contribution switching the documentation build to Sphinx's dirhtml builder for extensionless URLs. CLA signed, workflows re-triggered for apt wheel availability, and changes integrated. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1064 docs(build): switch to extensionless URLs | craft-parts | merged | Merged #1064 restored extensionless documentation URLs to prevent link rot in external references; commit 845bd2fa also added a changelog entry. | |
| #5328 chore(rtd): switch to extensionless URLs | snapcraft | merged | Merged #5328 (commit 5cdd7c69f), adding a Sphinx setting that removes .html suffixes from documentation URLs. | |
| #818 docs: fix extensions urls | rockcraft | closed | Closed unmerged; its .html-link fix was superseded by #820 (571f1459), which adopted extensionless documentation URLs. | |
| #1075 fix: remove .html extension from doc slug | craft-parts | merged | Merged PR #1075 in commit 24238ae8, removing the .html extension from documentation slugs to use extensionless Read the Docs URLs. | |
| #325 docs: use canonical-sphinx | craft-application | merged | Merged PR #325 in commit 8ca97e1a, migrating the docs to canonical-sphinx and removing unused extensions and configuration. | |
| #209 docs: use canonical-sphinx | starbase | merged | Merged PR #209 (commit cd48e13) migrated the documentation build from legacy Sphinx configuration to canonical-sphinx. | |
| #249 docs: use canonical-sphinx extension | craft-cli | merged | Merged PR #249 adopted the canonical-sphinx extension, removing 1,134 lines of legacy documentation configuration. | |
| #106 docs: use canonical-sphinx | craft-archives | merged | Merged PR #106 switched the documentation build to canonical-sphinx in commit 9f73ab6. |