Skip to content

Define Downstream Rollout and Maintenance Guidance#9

Draft
FMCalisto with Copilot wants to merge 2 commits into
mainfrom
copilot/define-downstream-rollout-guidance
Draft

Define Downstream Rollout and Maintenance Guidance#9
FMCalisto with Copilot wants to merge 2 commits into
mainfrom
copilot/define-downstream-rollout-guidance

Conversation

Copilot AI commented Jul 11, 2026

Copy link
Copy Markdown

Closes #5

Downstream maintainers had no single reference covering what to do after templating a repo, which files are mandatory vs removable, or how to track template evolution.

Changes

docs/DOWNSTREAM_GUIDE.md (new)

Five-section guide covering:

  • Minimum post-template setup — ordered steps required before the repo is usable
  • Required customization points — table of every file containing placeholders or instructional text that must be replaced
  • Mandatory items to retain — community health and governance files that must stay present
  • Optional items — what can be removed and under what conditions; explicitly scopes stack-specific automation and compliance tooling as out-of-default (informed by discussions Which Optional Extensions Should Stay Outside the Default Template? #7 and What Should Remain Mandatory in Downstream Repositories? #8)
  • Template evolution — how downstream repos track changes and what compatibility the source template guarantees

TEMPLATE_CHECKLIST.md

Added a final-review item directing maintainers to confirm required customization points against the new guide before deleting the checklist.

docs/README.md

Linked DOWNSTREAM_GUIDE.md at the top of the template administration resources list.

- Add docs/DOWNSTREAM_GUIDE.md covering minimum post-template setup
  steps, required customization points, mandatory vs optional items,
  and template evolution compatibility expectations
- Update docs/README.md to link to the new guide
- Update TEMPLATE_CHECKLIST.md final review to reference the guide

Closes #5
Copilot AI changed the title [WIP] Define downstream rollout and maintenance guidance docs: add downstream rollout and maintenance guide Jul 11, 2026
Copilot AI requested a review from FMCalisto July 11, 2026 22:14
@FMCalisto FMCalisto added the documentation Type: documentation for something. label Jul 11, 2026
@FMCalisto FMCalisto changed the title docs: add downstream rollout and maintenance guide Define Downstream Rollout and Maintenance Guidance Jul 11, 2026
@FMCalisto FMCalisto added medium Priority: medium priority issue. review Status: review is needed from the issue owner. labels Jul 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Type: documentation for something. medium Priority: medium priority issue. review Status: review is needed from the issue owner.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define Downstream Rollout and Maintenance Guidance

2 participants