docs: explanation section for overlays
Metadata
Current evaluation
Merged documentation update adding an explanation section for overlays. Depends on and incorporates PR #365. Resolves CRAFT-1560. Approved by one reviewer with 273 additions and 9 deletions across eight files.
Suggested action: —
No scores available.
Issue body
- [x] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)?
-----
This depends on #365 and incorporates its changes. I will unmark as draft once that PR has been merged.
Fixes CRAFT-1560
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Merged documentation update adding an explanation section for overlays. Depends on and incorporates PR #365. Resolves CRAFT-1560. Approved by one reviewer with 273 additions and 9 deletions across eight files. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged documentation update adding an explanation section for overlays. Resolves CRAFT-1560 and incorporates changes from PR #365. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #365 docs: include overlays in the lifecycle documentation. | craft-parts | merged | Merged documentation update adding overlay information to the lifecycle guide. Approved by two reviewers. A lint issue was addressed separately in PR #366. Changes modified 4 files with 85 additions and 1 deletion. | |
| #795 docs: add labels for overlay step | craft-parts | merged | Merged documentation update adding labels for the overlay step. Fixes a reference issue for applications excluding the overlay explanation page and unblocks CRAFT-3043. Approved by two reviewers and passed CI checks. | |
| #404 docs: add an explanation of parts | craft-parts | merged | Merged documentation update explaining parts, adding 628 lines across nine files. Approved by one reviewer, references CRAFT-1612, and was finalized after initial feedback collection. | |
| #322 docs: enable inclusion of overlay document | rockcraft | merged | Merged documentation changes enabling overlay document inclusion. Approved by three reviewers, passed CI checks, and implemented via a single-line configuration update. | |
| #1473 docs: add override-overlay | craft-parts | merged | Merged documentation update adding override-overlay. Approved by three reviewers and passed CI checks despite two failing edge tests. Changes span six files with 20 additions and 8 deletions. | |
| #1453 docs: fix headings in 'Overlay step' explanation | craft-parts | merged | Merged documentation fix correcting top-level headings in the 'Overlay step' explanation that incorrectly appeared in the Table of Contents. Approved by reviewer, passed CI checks, and integrated with minor changes to two files. | |
| #436 feat(docs): add definition for overlay_step in the docs | rockcraft | merged | Merged documentation update adding the missing overlay_step definition to Rockcraft docs. Maintainers chose to merge the standalone paragraph as-is, deferring upstream craft-parts doc inheritance improvements for later. | |
| #113 overlay: add overlay support to parts (CRAFT-470) | craft-parts | merged | Merged after three approvals. Adds overlay support to parts by defining the work directory and properties for overlay subdirectories and visibility. 149 additions, 37 deletions across six files. Removed Final typing hint for Python 3.7. | |
| #1401 Docs: Rewrite `overlay` field description | craft-parts | closed | Overlay field documentation was rewritten to fix typos, clarify exhaustive list behavior, and explain path negation syntax. The issue was closed after documentation updates clarifying example usage and negation behavior. | |
| #110 feat: Support overlay | imagecraft | merged | Merged to enable the overlay feature, provide a bare base, and add spread tests. Approved by two reviewers with passing CI checks. Resolves #98 and CRAFT-4269 across 18 files. |