← Back to issue list

docs: odd Explanation tree/page rendering

View original Github issue

Metadata

Project
craft-providers
Number
#894
Type
issue
State
open
Author
steinbro
Labels
Type: Bug
Created
Updated
Closed

Current evaluation

Documentation rendering bug: network error section appears in page but not sidebar due to missing toctree entry

Suggested action: needs triage

Reason: The issue is a valid documentation bug — the 'Failure to properly execute commands that depend on network access' section exists in docs/explanation/index.rst but is not included in the toctree directive, causing it to render in the page body but not appear in the sidebar navigation. However, with 0 maintainer comments and no activity for 136 days, it has not yet been triaged or acknowledged.

Impact: 20 Quick Win: 19.0 Staleness: 65 Complexity: 5 Confidence: 75 Support Request: 0

Issue body

### Bug Description The "Failure to properly execute commands that depend on network access" page is strangely both in and not in the Explanation section, both as rendered in the sidebar and what's shown in the main body when selected. This feels like a minor syntax error somewhere in the docs structure. <img width="2732" height="2047" alt="Image" src="https://github.com/user-attachments/assets/3c8509cc-ae3b-44d9-b38e-252bdc0a1cd8" />. ### To Reproduce Visit: https://canonical-craft-providers.readthedocs-hosted.com/en/latest/explanation/#failure-to-properly-execute-commands-that-depend-on-network-access ### part yaml ```shell ``` ### Relevant log output ```shell N/A ```

Evaluation history

Date Model Scores Action Summary
qwen3.6-35b-a3b-mtp-q6
Impact: 20
Quick Win: 19.0
Staleness: 65
Complexity: 5
Confidence: 75
Support Request: 0
needs triage Documentation rendering bug: network error section appears in page but not sidebar due to missing toctree entry
qwen/qwen3.6-35b-a3b
Staleness: 65
Complexity: 15
Confidence: 85
Support Request: 5
keep open Documentation rendering issue where a specific explanation page appears incorrectly in the sidebar and main body, likely due to a minor syntax error in the docs structure. Currently unaddressed after ~3 months.
qwen3.6-35b-a3b-mtp-q6
Staleness: 60
Complexity: 15
Confidence: 80
Support Request: 5
keep open Documentation rendering issue where a specific explanation page appears incorrectly in the sidebar and main body, likely due to a minor syntax or configuration error in the docs structure.
qwen3.6-35b-a3b-mtp-q6
Staleness: 45
Complexity: 15
Confidence: 85
Support Request: 10
needs triage Documentation rendering bug where a specific explanation page appears incorrectly in the sidebar and main body. Reported by a maintainer, currently unassigned with no maintainer comments or progress in over five months.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.