docs: refine home and landing pages
Metadata
Current evaluation
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.
Suggested action: —
No scores available.
Issue body
* Make the introductory paragraphs on the home page more punchy
* Remove the **Build** sub-landing page
* Rewrite remaining landing pages
---
- [X] I've followed the [contribution guidelines](https://github.com/canonical/charmcraft/blob/main/CONTRIBUTING.md).
- [X] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
~~I've successfully run `make lint && make test`.~~
- [X] I've added or updated any relevant documentation.
- [it's 11pm] In documents I changed, I [added a meta description](https://canonical-starflow.readthedocs-hosted.com/how-to/add-a-page-meta-description/) if one was missing.
~~I've updated the relevant release notes.~~
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | 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. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation updates refining home and landing pages. Changes include punchier intros, removal of the Build sub-page, and rewrites of remaining pages. Automated type-checking warnings were noted as non-actionable and did not block the merge. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation updates refining home and landing pages, including rewritten text and removal of the Build sub-landing page. CI type-checking warnings were flagged but explicitly noted as non-blocking notifications. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #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. | |
| #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. | |
| #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. | |
| #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. | |
| #111 docs: remove placeholder links at bottom of home page | imagecraft | merged | Merged documentation update removing eight placeholder links from the home page bottom. Approved by two reviewers, the change modifies one file and eliminates outdated navigation elements. | |
| #2648 docs: adopt new home page model | charmcraft | merged | Merged documentation updates adopting a new home page model, renaming tutorials, and redesigning the overview. Approved by two reviewers with all CI checks passing. Type checker warnings were informational. Changes span 7 files with +97/-66 lines. | |
| #370 docs: remove placeholder links at bottom of home page | starbase | merged | Merged a documentation update removing placeholder links from the bottom of the home page. Approved by one reviewer, passed CI checks, and modified one file by deleting eight lines. | |
| #5441 docs: revise home page | snapcraft | merged | Merged documentation update revising the home page. Approved by two reviewers, rebased against a reorganized table of contents, and merged by maintainer medubelko. |