docs: refine landing pages
Metadata
Current evaluation
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.
Suggested action: —
No scores available.
Issue body
- [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`?
---
* Incorporate standard Diátaxis category introductions and add sort pages into basic groups
* Move common parts explanations from the reference category into the explanation category
* Update filenames and labels to better align with our standard practices
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | 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. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation updates to landing pages. Applied Diátaxis standards, reorganized content into basic groups, moved common parts explanations to the explanation category, and updated filenames and labels to match project practices. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation updates refining landing pages. Added Diátaxis introductions, grouped sort pages, relocated common parts explanations, and updated filenames and labels to match project standards. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #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. | |
| #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. | |
| #2679 docs: refine home and landing pages | charmcraft | merged | Merged documentation updates refining home and landing pages. Changes include punchier intro text, removal of the Build sub-landing page, and rewrites of remaining pages. Approved by two reviewers and merged despite non-blocking type warnings. | |
| #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. | |
| #5446 docs: align landing pages with model | snapcraft | merged | Merged documentation update aligning landing pages with the model. Approved by one reviewer, modified seven files (+140/-11). Maintainer medubelko completed the merge despite some pending integration and security scan failures. | |
| #5858 docs: use lists for all links in landing pages | snapcraft | merged | Merged documentation update standardizing landing page links into lists. Approved by two reviewers, passed all CI checks, and modified four files with minimal changes. | |
| #1316 docs: add content to how-to landing pages | rockcraft | merged | Merged documentation update aligning the Crafting, Chiseling, and Documentation landing pages with the required model and adding missing metadata descriptions. Approved by two reviewers and passed all CI checks. | |
| #2272 docs: align landing pages with model | charmcraft | merged | Aligned main Diátaxis landing pages (tutorial, how-to, reference) with the standard landing page model. Merged after approval by two reviewers, modifying eight files with 158 additions and 23 deletions. | |
| #1015 docs: use lists for all links in landing pages | rockcraft | merged | Merged documentation update standardizing link formatting by converting them to lists across four landing page files. Approved by two reviewers and passed CI checks before integration. | |
| #1001 docs: maintain how-to quadrant | rockcraft | merged | 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. |