docs: update 12-factor tutorials
Metadata
Current evaluation
Merged in #2085 (79fa5ad9), updating 12-factor tutorials to rST, incorporating UX feedback, and standardizing content after #2083.
Resolution: closed resolved
Reason: PR #2085 was merged as commit 79fa5ad9 after review. It converted the tutorials to reStructuredText, applied UX feedback, and aligned their content.
Evaluated by: mr-cal-bot
No scores available.
Issue body
Update the 12-factor tutorials.
Specific updates:
- Convert to reStructuredText
- Incorporate feedback from UX session with Daniele
- Update all tutorials for consistency (feedback from previous PRs, feedback from Daniele)
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Merged in #2085 (79fa5ad9), updating 12-factor tutorials to rST, incorporating UX feedback, and standardizing content after #2083. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged as canonical/charmcraft#2085 (79fa5ad9): converted 12-factor tutorials to reStructuredText, applied UX feedback, and aligned content after rebasing on #2083. | |
| qwen/qwen3.6-35b-a3b | — | — | Merged after converting the 12-factor tutorials to reStructuredText and incorporating UX feedback. Conflicts with PR #2083 were resolved via maintainer coordination before finalizing the merge. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged following conflict resolution with PR #2083. Converted 12-factor tutorials to reStructuredText and incorporated UX feedback. Remaining updates were completed after the base branch was updated. |
Update history
No update history recorded yet.
Related work
-
Related To:
canonical/charmcraft#2083
(confidence 99%)
Merged first as 8732a51a; its Markdown-to-rST conversion overlapped with this PR, which was subsequently rebased.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #2257 Docs: 12-factor tutorial updates | charmcraft | merged | Merged PR #2257 as commit e549afa7, applying six clarity, terminology, and formatting updates across all four 12-factor tutorials. | |
| #893 docs: Incorporate UX feedback into 12-factor tutorials | rockcraft | merged | Merged as 9a40a4a3, updating 12-factor tutorials with clearer skopeo guidance, file headers, and corrected Express and Spring Boot setup instructions. | |
| #2455 docs: Incorporate UX feedback into 12-factor tutorials | charmcraft | merged | Docs-only PR merged to main as commit d31736f1, applying UX-session feedback (ISD-4286) to the 12-factor tutorials: reworded the project-directory cleanup step, removed explicit cd commands, and moved code-block comments into prose. | |
| #918 docs: Incorporate UX feedback into 12-factor tutorials | rockcraft | merged | Merged PR #918 as ddb5bbba, updating the 12-factor tutorials with UX feedback on architecture, setup, Multipass, multi-architecture commands, pack warnings, and terminology. | |
| #2445 docs: Incorporate UX feedback into 12-factor tutorials | charmcraft | merged | Merged PR #2445 as commit 787f82c4, updating six 12-factor tutorial files with UX feedback on resources, ingress, configuration, wording, and PostgreSQL setup. | |
| #2742 docs: 12 factor v2 | charmcraft | merged | Merged the 12-factor v2 documentation overhaul across 26 files in commit 91f9fc06 after reST fixes and three approvals. | |
| #2425 docs: Incorporate UX feedback into 12-factor tutorials | charmcraft | merged | Merged docs PR applying UX-session feedback to the 12-factor tutorials (commit 17ce91b5, 8 files, +349/-207): reordered rockcraft.yaml arch steps, reworded rock upload, code-blocked curl/config commands, and refreshed next-step links. | |
| #2220 docs: 12-factor tutorial maintenance | charmcraft | merged | Merged canonical/charmcraft#2220, updating four 12-factor tutorials with numbered task lists, tilde-prefixed paths, full-path captions, and consistent app.py naming. | |
| #2387 docs: Incorporate UX feedback into 12-factor tutorials | charmcraft | merged | Docs-only PR merged (commit 6368b845): applied UX session feedback to the 12-factor tutorials — added Deploy intro, Verify/Destroy app steps, an achievements section, and a PostgreSQL spelling fix (+125/-81, 5 files). | |
| #2263 docs: 12-Factor tutorial updates | charmcraft | merged | Merged PR #2263 as commit 410dcd0b, updating all four 12-factor tutorials and shared setup scripts with clearer naming, corrected links, --profile guidance, and revised Django instructions. |