docs: refine home and landing pages
Metadata
Current evaluation
Merged as 557b4b93: sharpened home-page introductions, removed the Build landing page, and rewrote the remaining landing pages.
Resolution: closed resolved
Reason: PR canonical/charmcraft#2679 was approved and merged into main as commit 557b4b93, completing the documentation restructuring described in the PR.
Evaluated by: mr-cal-bot
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 |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Merged as 557b4b93: sharpened home-page introductions, removed the Build landing page, and rewrote the remaining landing pages. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged in charmcraft#2679 (commit 557b4b93), refining home-page introductions, removing the Build sub-landing page, and rewriting the remaining landing pages. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged in charmcraft#2679 (commit 557b4b93): refined home-page introductions, removed the Build sub-landing page, and rewrote the remaining landing pages. | |
| 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. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #223 docs: refine landing pages | imagecraft | merged | Merged in commit c58ecb8, adding Diátaxis landing pages, basic-group indexes, reorganized common-parts explanations, and standardized filenames and labels. | |
| #339 docs: update home and landing pages | imagecraft | merged | Merged docs refresh in canonical/imagecraft#339 (commit 8c865f0): shortened home copy, added File manipulation, rewrote Plugins, and fixed wording and a typo. | |
| #2217 docs: rewrite home page | charmcraft | merged | Merged PR #2217 in commit 9f3d6ebd, rewriting the documentation home page to the standard model and fixing reference-doc lint errors; remaining feedback was deferred. |