docs: refactor tutorial
Metadata
Current evaluation
Docs refactor moving tutorials to how-to guides and adding NGINX static HTML tutorial. 76 files changed. Review status changes_requested; maintainer said approach was 'perhaps not in this way' and to hold. Docs since reorganized separately, superseding this PR's structure.
Suggested action: close stale
Reason: Maintainer @cjdcordeiro stated the approach was 'perhaps not in this way' and advised holding until sprint discussion. Since then (381 days), the docs were reorganized separately: 12-factor how-to guides reorganized in #877, tutorial quadrant maintained in #1002, and numerous individual tutorial updates merged. The PR's core proposal (moving tutorials to how-to, NGINX static HTML tutorial) was not adopted, and the review remains in changes_requested with no author follow-up.
Issue body
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.8-27b |
Impact:
35
Quick Win:
9.8
Staleness:
88
Complexity:
72
Confidence:
78
|
close stale | Docs refactor moving tutorials to how-to guides and adding NGINX static HTML tutorial. 76 files changed. Review status changes_requested; maintainer said approach was 'perhaps not in this way' and to hold. Docs since reorganized separately, superseding this PR's structure. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
75
Complexity:
15
Confidence:
90
|
keep open | Refactors documentation by consolidating tutorials and moving framework guides to how-to sections. Currently on hold pending internal sprint discussions to finalize structure and terminology. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
35
Complexity:
45
Confidence:
90
|
keep open | Refactors documentation to consolidate tutorials into a single end-to-end guide and moves older tutorials to how-to sections. Currently on hold pending architectural decisions and stakeholder alignment on documentation structure. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
85
Complexity:
25
Confidence:
75
|
close stale | Refactors tutorial structure by consolidating content into a single end-to-end guide and moving legacy tutorials to how-to sections. Currently inactive for over a year after being explicitly shelved pending sprint planning. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
75
Complexity:
20
Confidence:
90
|
keep open | Refactors the documentation tutorial into a single end-to-end guide, moving legacy examples to how-to sections. Currently on hold pending sprint planning to resolve Diataxis alignment and 12-factor tutorial structure concerns. |
Update history
No update history recorded yet.
Related work
-
Related To:
canonical/rockcraft#877
(confidence 70%)
Reorganized 12-factor how-to guides separately, addressing part of this PR's restructuring goal in a different way
-
Related To:
canonical/rockcraft#1002
(confidence 65%)
Maintained the tutorial quadrant, indicating the existing tutorial structure was kept rather than merged into how-to as this PR proposed
Related issues
No related issues found above the similarity threshold.