docs: add content to how-to landing pages
Metadata
Current evaluation
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.
Suggested action: —
No scores available.
Issue body
The following landing pages in the how-to section do not fit the required model:
- Crafting
- Chiseling
- Documentation
This PR updates them to fit the model. Metadata descriptions have also been added to those missing them.
---
- [x] I've followed the [contribution guidelines](https://github.com/canonical/rockcraft/blob/main/CONTRIBUTING.md).
- [x] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
- [x] I've successfully run `make lint && make test`.
- [ ] I've added or updated any relevant documentation.
- [x] 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 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. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
10
Confidence:
90
|
needs review | Updates how-to landing pages for Crafting, Chiseling, and Documentation to match the required model and adds missing metadata descriptions. Approved by one reviewer, ready for merge. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
10
Confidence:
90
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. Approved by one reviewer, no unresolved comments, and ready for merge. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
45
Complexity:
10
Confidence:
90
|
needs review | Updates how-to landing pages for Crafting, Chiseling, and Documentation to match the required model and adds missing metadata descriptions. Currently pending maintainer review with no comments or CI runs. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
10
Confidence:
90
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. Currently awaiting maintainer review with no CI checks run. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
15
Complexity:
10
Confidence:
90
|
needs review | Updates Crafting, Chiseling, and Documentation landing pages to match the required content model and adds missing metadata descriptions. Currently awaiting maintainer review with no CI checks triggered. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
15
Confidence:
85
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. Currently pending maintainer review with no comments or CI results yet. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
10
Confidence:
90
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. All CI checks pass, awaiting maintainer review. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
5
Confidence:
90
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. All CI checks pass. Currently awaiting maintainer review. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
5
Confidence:
90
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. All CI checks pass. Awaiting maintainer review. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
10
Confidence:
90
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. All CI checks pass. Awaiting maintainer review. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
15
Confidence:
90
|
needs review | Updates three how-to landing pages to match the required documentation model and adds missing metadata descriptions. All CI checks pass, awaiting maintainer review. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
5
Confidence:
90
|
needs review | Updates how-to landing pages (Crafting, Chiseling, Documentation) to match the required documentation model and adds missing metadata descriptions. Currently pending maintainer review with all CI checks passing. |
Update history
| Date | Change |
|---|---|
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| created |
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. | |
| #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. | |
| #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. | |
| #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. | |
| #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. | |
| #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. | |
| #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. | |
| #1246 docs: add metadata to all remaining pages | rockcraft | merged | Merged after approval and passing CI checks. Added metadata and meta descriptions to 67 documentation pages per Starflow guidelines. Author addressed feedback and fixed Chisel docs redirect errors. 191 additions and 3 deletions across 67 files. | |
| #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. | |
| #447 docs: rename page, change order, fix markup | craft-parts | merged | Merged documentation update that renamed a page, reordered content, and corrected markup. Approved by one reviewer, passed CI checks, and modified three files with a net change of one line. |