docs: refine landing pages
Metadata
Current evaluation
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.
Suggested action: —
No scores available.
Issue body
- [X] Have you followed the [guidelines for contributing](https://github.com/canonical/snapcraft/blob/main/CONTRIBUTING.md)?
- [X] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)?
- [X] Have you successfully run `make lint`?
- [ ] Have you successfully run `make test`?
---
* Incorporate standard Diátaxis category introductions
* Add a proper 'Explanation' landing page
Sorry for the noise in the diff. I don't even realize I'm messing with the whitespace until I open the PR. :disappointed:
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | 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. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation updates refining landing pages with standard Diátaxis category introductions and a new explanation page. Integrated into main without further review. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation update refining landing pages. Added Diátaxis category introductions and a dedicated Explanation landing page. Changes were integrated without additional comments. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #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. | |
| #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. | |
| #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. | |
| #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. | |
| #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. | |
| #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. | |
| #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. |