This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow-steward.git
The following commit(s) were added to refs/heads/main by this push:
new d7802a9 docs: add template setup order (#422)
d7802a9 is described below
commit d7802a9b00b4f0dba508976ec1ae8906542b133e
Author: anhtnt90dev <[email protected]>
AuthorDate: Mon Jun 1 00:58:08 2026 +0700
docs: add template setup order (#422)
---
projects/_template/README.md | 22 ++++++++++++++++++++++
1 file changed, 22 insertions(+)
diff --git a/projects/_template/README.md b/projects/_template/README.md
index 7482a15..2cae740 100644
--- a/projects/_template/README.md
+++ b/projects/_template/README.md
@@ -13,6 +13,7 @@
- [Editorial + reporter-facing](#editorial--reporter-facing)
- [Issue management](#issue-management)
- [PR triage and review](#pr-triage-and-review)
+ - [Recommended setup order](#recommended-setup-order)
- [Checklist after copying](#checklist-after-copying)
- [Cross-references](#cross-references)
@@ -129,6 +130,27 @@ fill them in.
> values, which new adopters can use as a reference when drafting
> their own configuration).
+## Recommended setup order
+
+After copying the template, fill in the core project files before the
+optional skill-family files:
+
+1. Start with `project.md`, because every skill uses it to resolve
+ project-scoped references.
+2. Fill in `security-model.md` so security-facing workflows have an
+ authoritative source.
+3. Add current release details to `release-trains.md`.
+4. Define tracker organization in `scope-labels.md` and `milestones.md`.
+5. Prepare reporter-facing text in `canned-responses.md`.
+6. Document the fix flow in `fix-workflow.md`.
+7. If your project uses the issue or PR-management skill families, fill
+ in the optional files they read, such as `issue-tracker-config.md`,
+ `runtime-invocation.md`, `pr-management-config.md`, and
+ `pr-management-code-review-criteria.md`.
+
+Run `grep -rn TODO projects/<name>` after copying and again before
+opening a pull request so no template placeholders are left behind.
+
## Checklist after copying
- [ ] `cp -R projects/_template projects/<name>` done.
