docs: add howto for using partitions
Metadata
Current evaluation
Merged a how-to guide for using partitions. Approved by two reviewers, the update adds 197 lines across two files to document partition usage within the project. Resolves CRAFT-3068.
Suggested action: —
No scores available.
Issue body
- [x] Have you followed the guidelines for contributing?
- [x] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)?
- [x] Have you successfully run `tox`?
-----
Add howto guide for using partitions.
You could argue that some of this content should really go into `craft-parts` documentation, but I would respond that doing that would make the document less useful.
(CRAFT-3068)
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Merged a how-to guide for using partitions. Approved by two reviewers, the update adds 197 lines across two files to document partition usage within the project. Resolves CRAFT-3068. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged a how-to guide for using partitions, authored by maintainer mattculler. Documentation was kept separate from craft-parts to improve usability. Resolves CRAFT-3068. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #763 partitions feature documentation | craft-parts | merged | Merged documentation for the partitions feature targeting application developers. Approved by two reviewers, the update adds 66 lines and removes 5 across nine files, resolving CRAFT-3030. | |
| #600 feat(partitions): handle namespaced partitions in utils | craft-parts | merged | Merged following two reviewer approvals and passing CI. Updates utility functions to handle namespaced partitions across eight files (+229/-72 lines). Resolves #596 and CRAFT-2303. | |
| #497 partitions: add utility to make partition compatible filepaths | craft-parts | merged | Merged utility function to convert filepaths to partition-compatible formats. Approved by two reviewers, the change adds 184 lines across two files and addresses CRAFT-1845. | |
| #754 Document Partitions | craft-parts | closed | Completed and merged via pull request #763 in canonical/craft-parts, adding the requested Partitions documentation to enable application integration and reuse. | |
| #801 fix: partitions break when using special characters | craft-parts | merged | Merged fix for CRAFT-3031 resolving lifecycle failures from misinterpreted paths in partitions with numbers and hyphens. Approved by two reviewers, the change updates four files to correctly handle special characters. | |
| #475 feat: update partitions docs | craft-application | merged | Merged documentation update for partitions, correcting instructions on resetting Features and overriding Application methods. Approved by three reviewers, passed CI, and modified two files. | |
| #493 partitions: validate usage of partitions in parts | craft-parts | merged | Implemented partition validation for filepaths in the organize, overlay, stage, and prime keywords within parts. Merged after reviewer approval and passing CI checks, modifying seven files to resolve CRAFT-1844. | |
| #5350 docs: add how-to for cross compiling autotools | snapcraft | merged | Merged documentation update adding a how-to guide for cross-compiling autotools. Approved by two reviewers, passed CI checks, and added 198 lines across four files. Resolves CRAFT-4328. | |
| #800 feat: allow hyphens in partition names | craft-parts | merged | Merged to allow hyphens in partition names. Approved by two reviewers, the change updates five files with 85 additions and 51 deletions, resolving CRAFT-3031. | |
| #1110 feat: cleaning with partitions | craft-parts | merged | Merged after craft-parts PR #1109. Properly cleans the shared area while accounting for partitions, resolving issue #665. Includes a changelog entry and passed three reviews. |