docs: maintain how-to quadrant
Metadata
Current evaluation
Merged following two reviewer approvals and successful CI checks. Changes reorganize the landing page, refine wording, rename sections, harmonize titles and anchors, and resolve a 12-factor intersphinx bug. Updated documentation is now live.
Suggested action: —
No scores available.
Issue body
- Reorganise landing page.
- Improve the wording of the landing page.
- Rename 'rocks' and 'chisel' sections.
- Harmonize page titles and anchors.
- Fix a bug with the 12-factor intersphinx name.
Before:
<img width="33%" alt="image" src="https://github.com/user-attachments/assets/6c179363-eb7c-4202-9831-9643dd323739" />
After:
<img width="33%" alt="image" src="https://github.com/user-attachments/assets/8f99b4a5-830f-49eb-8680-0dd15ede1df0" />
---
- [x] Have you followed the guidelines for contributing?
- [x] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)?
- [x] Have you successfully run `make lint && make test`?
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Merged following two reviewer approvals and successful CI checks. Changes reorganize the landing page, refine wording, rename sections, harmonize titles and anchors, and resolve a 12-factor intersphinx bug. Updated documentation is now live. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation update reorganizing the landing page, improving wording, renaming rocks and chisel sections, harmonizing titles and anchors, and fixing a 12-factor intersphinx bug. Approved and merged by maintainer medubelko. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation updates to the landing page and how-to quadrant. Changes include layout reorganization, improved wording, section renaming, title and anchor harmonization, and a 12-factor intersphinx bug fix. Merged by maintainer medubelko. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1002 docs: maintain the tutorial quadrant | rockcraft | merged | Merged documentation update aligning the landing page with the model and adjusting tutorial titles and anchors. Approved by two reviewers, passed CI checks, and modified 21 files. | |
| #1012 docs: maintain reference quadrant | rockcraft | merged | Merged documentation updates aligning the Explanation landing page with the model, standardizing labels, and updating reference titles and heading levels. Approved by two reviewers and merged despite a failing snap-test check. | |
| #1011 docs: maintain explanation quadrant | rockcraft | merged | Merged documentation updates aligning the explanation landing page with the model, standardizing labels, and ingesting common docs. Approved by two reviewers and merged despite a failing snap-tests CI check. | |
| #2470 docs: improve landing pages | charmcraft | merged | Merged documentation update improving landing pages with Diátaxis introductions, a reorganized table of contents, and a fixed link. Approved by two reviewers. CI type-check warnings were non-blocking notifications and did not prevent the merge. | |
| #223 docs: refine landing pages | imagecraft | merged | Merged documentation update refining landing pages. Content was reorganized per the Diátaxis framework, explanations were moved, and filenames and labels were updated. Approved by two reviewers and passed all CI checks across nine files. | |
| #339 docs: update home and landing pages | imagecraft | merged | Merged documentation updates to home and landing pages, including shortened text, a new category, rewritten plugins page, casing fixes, and a typo correction. Approved by two reviewers and integrated after passing CI checks. | |
| #2128 docs: add anchors and fix a few small things | charmcraft | merged | Merged documentation updates adding intersphinx anchors, renaming sections for consistency, fixing rendering issues, and resolving linting errors. Approved by reviewers and integrated after manual fixes. | |
| #5847 docs: refine landing pages | snapcraft | merged | Merged documentation updates refining landing pages. Changes incorporate standard Diátaxis category introductions and add a dedicated Explanation landing page. All CI checks passed and approvals were granted before merge. | |
| #2326 docs: Update 12-factor how-to landing page | charmcraft | merged | Merged documentation update to the 12-factor how-to landing page, adding context to the guides. Approved by two reviewers and rebased to the hotfix/3.5 branch before successful merge. | |
| #5440 docs: reorganise pages | snapcraft | merged | Merged after reorganizing documentation pages to improve the learning path and content chunking. Approved by two reviewers, failing integration tests were resolved, and the maintainer completed the merge. |