From 11d3de3e65ea34c63398d74fac1a8f93160541eb Mon Sep 17 00:00:00 2001 From: Sal <59910950+ss-o@users.noreply.github.com> Date: Tue, 6 Oct 2026 09:11:07 +0100 Subject: [PATCH] chore(github): vendor the organization issue forms Replace the outdated copies of the organization forms 01 to 04 with byte-for-byte copies of z-shell/.github .github/ISSUE_TEMPLATE at 8ea2c800 and add the forms 05 to 07. The documentation request form and config.yml are unchanged. Refs z-shell/.github#717 Refs z-shell/.github#720 --- .github/ISSUE_TEMPLATE/01_bug_report.yml | 10 +- .github/ISSUE_TEMPLATE/02_feature_request.yml | 12 ++- .../03_codebase_improvement.yml | 8 +- .github/ISSUE_TEMPLATE/04_documentation.yml | 6 +- .github/ISSUE_TEMPLATE/05_membership.yml | 95 +++++++++++++++++++ .github/ISSUE_TEMPLATE/06_agent_handoff.yml | 85 +++++++++++++++++ .../ISSUE_TEMPLATE/07_delivery_initiative.yml | 70 ++++++++++++++ 7 files changed, 268 insertions(+), 18 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/05_membership.yml create mode 100644 .github/ISSUE_TEMPLATE/06_agent_handoff.yml create mode 100644 .github/ISSUE_TEMPLATE/07_delivery_initiative.yml diff --git a/.github/ISSUE_TEMPLATE/01_bug_report.yml b/.github/ISSUE_TEMPLATE/01_bug_report.yml index 5c96929a8..6522829d1 100644 --- a/.github/ISSUE_TEMPLATE/01_bug_report.yml +++ b/.github/ISSUE_TEMPLATE/01_bug_report.yml @@ -1,7 +1,7 @@ name: "🐞 Bug report" description: File a bug report title: "[bug]: " -labels: ["bug 🐞", "triage 📑"] +labels: ["type:bug", "status:triage"] assignees: ["ss-o"] body: - type: markdown @@ -14,13 +14,11 @@ body: label: Environment description: > Please describe your environment in as much detail as possible. Otherwise, we may not be able to reproduce the issue. - placeholder: > Example: print "Device: $VENDOR | $OSTYPE | $CPUTYPE" print "Shell: $SHELL | $ZSH_ARGZERO | $ZSH_PATCHLEVEL" print "Zi: $(git -C $ZI[BIN_DIR] rev-parse HEAD)" - validations: required: true - type: textarea @@ -89,18 +87,18 @@ body: If you feel like you could contribute to this issue, please check the box below. This would tell us and other people looking for contributions that someone's working on it. If you do check this box, please send a pull request within 7 days so we can still delegate this to someone else. options: - - label: I'd be willing to address this documentation request myself. + - label: I'd be willing to fix this bug myself. - type: checkboxes attributes: label: Have you read the Contributing Guidelines? options: - - label: I have read the [Contributing Guidelines](https://github.com/z-shell/community/blob/main/docs/CONTRIBUTING_GUIDELINES.md). + - label: I have read the [Contributing Guidelines](https://github.com/z-shell/.github/blob/main/.github/CONTRIBUTING.md). required: true - type: checkboxes attributes: label: Are you familiar with the Contributor Covenant Code of Conduct? options: - - label: I have read the [Contributor Covenant Code of Conduct](https://github.com/z-shell/zi/blob/main/docs/CODE_OF_CONDUCT.md). + - label: I have read the [Contributor Covenant Code of Conduct](https://github.com/z-shell/.github/blob/main/.github/CODE_OF_CONDUCT.md). required: true - type: input id: contact diff --git a/.github/ISSUE_TEMPLATE/02_feature_request.yml b/.github/ISSUE_TEMPLATE/02_feature_request.yml index 80cd628ce..fbbd0b469 100644 --- a/.github/ISSUE_TEMPLATE/02_feature_request.yml +++ b/.github/ISSUE_TEMPLATE/02_feature_request.yml @@ -1,7 +1,7 @@ name: "💡 Feature request" description: Suggest an idea for this project title: "[feat]: " -labels: ["feature-request 💡"] +labels: ["type:feature"] assignees: ["ss-o"] body: - type: markdown @@ -26,7 +26,9 @@ body: id: additional attributes: label: Additional Context - description: "List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to add, use case, Stack Overflow links, forum links, screenshots, OS if applicable, etc." + description: + "List any other information that is relevant to your issue. Stack traces, related issues, suggestions on how to add, use case, Stack Overflow links, forum links, screenshots, OS if applicable, + etc." validations: required: false - type: checkboxes @@ -36,18 +38,18 @@ body: If you feel like you could contribute to this issue, please check the box below. This would tell us and other people looking for contributions that someone's working on it. If you do check this box, please send a pull request within 7 days so we can still delegate this to someone else. options: - - label: I'd be willing to address this documentation request myself. + - label: I'd be willing to implement this feature myself. - type: checkboxes attributes: label: Have you read the Contributing Guidelines? options: - - label: I have read the [Contributing Guidelines](https://github.com/z-shell/community/blob/main/docs/CONTRIBUTING_GUIDELINES.md). + - label: I have read the [Contributing Guidelines](https://github.com/z-shell/.github/blob/main/.github/CONTRIBUTING.md). required: true - type: checkboxes attributes: label: Are you familiar with the Contributor Covenant Code of Conduct? options: - - label: I have read the [Contributor Covenant Code of Conduct](https://github.com/z-shell/zi/blob/main/docs/CODE_OF_CONDUCT.md). + - label: I have read the [Contributor Covenant Code of Conduct](https://github.com/z-shell/.github/blob/main/.github/CODE_OF_CONDUCT.md). required: true - type: input id: contact diff --git a/.github/ISSUE_TEMPLATE/03_codebase_improvement.yml b/.github/ISSUE_TEMPLATE/03_codebase_improvement.yml index 21d854c19..70dcba845 100644 --- a/.github/ISSUE_TEMPLATE/03_codebase_improvement.yml +++ b/.github/ISSUE_TEMPLATE/03_codebase_improvement.yml @@ -1,7 +1,7 @@ name: "✨ Codebase improvement" description: Suggest a better solution for algorithms, annexes, packages, development tools, etc. title: "[dev]: " -labels: ["enhancement ✨"] +labels: ["type:maintenance"] assignees: ["ss-o"] body: - type: textarea @@ -23,18 +23,18 @@ body: If you feel like you could contribute to this issue, please check the box below. This would tell us and other people looking for contributions that someone's working on it. If you do check this box, please send a pull request within 7 days so we can still delegate this to someone else. options: - - label: I'd be willing to address this documentation request myself. + - label: I'd be willing to make this improvement myself. - type: checkboxes attributes: label: Have you read the Contributing Guidelines? options: - - label: I have read the [Contributing Guidelines](https://github.com/z-shell/community/blob/main/docs/CONTRIBUTING_GUIDELINES.md). + - label: I have read the [Contributing Guidelines](https://github.com/z-shell/.github/blob/main/.github/CONTRIBUTING.md). required: true - type: checkboxes attributes: label: Are you familiar with the Contributor Covenant Code of Conduct? options: - - label: I have read the [Contributor Covenant Code of Conduct](https://github.com/z-shell/zi/blob/main/docs/CODE_OF_CONDUCT.md). + - label: I have read the [Contributor Covenant Code of Conduct](https://github.com/z-shell/.github/blob/main/.github/CODE_OF_CONDUCT.md). required: true - type: input id: contact diff --git a/.github/ISSUE_TEMPLATE/04_documentation.yml b/.github/ISSUE_TEMPLATE/04_documentation.yml index 5a55651cc..178e342ea 100644 --- a/.github/ISSUE_TEMPLATE/04_documentation.yml +++ b/.github/ISSUE_TEMPLATE/04_documentation.yml @@ -1,7 +1,7 @@ name: "📚 Documentation" description: The issue request for changes in documentation title: "[docs]: " -labels: ["documentation 📝"] +labels: ["type:docs", "area:docs"] assignees: ["ss-o"] body: - type: markdown @@ -31,7 +31,7 @@ body: label: Select the area that is associated with this issue. multiple: true options: - - ZI (this repository) + - General - Annexes - Plugins - Packages @@ -48,7 +48,7 @@ body: attributes: label: Have you read the Contributing Guidelines? options: - - label: I have read the [Contributing Guidelines](https://github.com/z-shell/community/blob/main/docs/CONTRIBUTING_GUIDELINES.md). + - label: I have read the [Contributing Guidelines](https://github.com/z-shell/.github/blob/main/.github/CONTRIBUTING.md). required: true - type: checkboxes attributes: diff --git a/.github/ISSUE_TEMPLATE/05_membership.yml b/.github/ISSUE_TEMPLATE/05_membership.yml new file mode 100644 index 000000000..748645cba --- /dev/null +++ b/.github/ISSUE_TEMPLATE/05_membership.yml @@ -0,0 +1,95 @@ +name: "👥 Community Membership Request" +description: Request member privileges +labels: ["type:membership", "area:meta"] +title: "team: " + +body: + - type: markdown + attributes: + value: | + Thanks for participating! + - type: input + attributes: + label: Username + description: GitHub username for the membership request. + placeholder: ex. @username + validations: + required: true + - type: input + id: contact + attributes: + label: Email + description: Public email + placeholder: ex. email@example.com + validations: + required: false + - type: checkboxes + id: email-fwd + attributes: + label: Assign @zshell.dev email forwarder + description: Email with GitHub username and @zshell.dev domain to be used when participating (ex. username@zshell.dev). + options: + - label: Assign email + required: false + - type: input + attributes: + label: Sponsors + description: GitHub usernames of sponsors if any. + placeholder: "@sponsor1, @sponsor2" + validations: + required: false + - type: dropdown + id: property + attributes: + label: "Property you are interested or would like to moderate." + options: + - General + - Annexes + - Plugins + - Packages + - Community + - Social media + - Documentation + - Technical writing + - Internationalization + - Other - described below + - type: textarea + attributes: + label: According to the selection above, please describe your role from your point of view. + description: > + Please try to describe in detail as much as possible, your role in the organization, daily routines, + what achievements you would set yourself, and what steps you would take. Any example is valid + validations: + required: true + - type: textarea + attributes: + label: Organization support + description: > + Please try to describe in detail as much as possible, your role in the organization, daily routines, + what achievents you would set yourself and what steps you would take. Any example is valid + validations: + required: false + - type: textarea + attributes: + label: Additional + description: Optional textarea to provide any additional information. + validations: + required: false + - type: checkboxes + id: contributing + attributes: + label: Governance & Steering committee. + description: > + By submitting this issue, you confirm to agree with [Organizational Governance and Policies for a Technical Steering Committee (TSC)](https://github.com/z-shell/.github/blob/main/governance/README.md) + options: + - label: "I am familiar with and agree with the governance & technical steering committee." + required: true + - type: checkboxes + id: terms + attributes: + label: Code of Conduct + description: > + By submitting this issue, you agree to follow and will cultivate the [Code of Conduct](https://github.com/z-shell/.github/main/governance/organization/CODE-OF-CONDUCT.md) + options: + - label: "I agree to sustain healthy interactions and will follow this project's Code of Conduct" + required: true diff --git a/.github/ISSUE_TEMPLATE/06_agent_handoff.yml b/.github/ISSUE_TEMPLATE/06_agent_handoff.yml new file mode 100644 index 000000000..0de2b883d --- /dev/null +++ b/.github/ISSUE_TEMPLATE/06_agent_handoff.yml @@ -0,0 +1,85 @@ +name: "🧠 Agent handoff" +description: Record cross-agent progress, blockers, and next steps for active or deferred work. +title: "[handoff]: " +labels: ["type:handoff", "area:meta"] +assignees: ["ss-o"] +body: + - type: markdown + attributes: + value: | + Use this only for work that needs shared context between maintainers or LLM agents. + If the work is a bug, feature, or documentation request, prefer the specific template and add the handoff details there. + - type: input + id: repository + attributes: + label: Repository + description: Owning repository for this work. + placeholder: z-shell/ + validations: + required: true + - type: input + id: branch-pr + attributes: + label: Branch or pull request + description: Branch name, pull request URL, or both. + placeholder: feature-example, https://github.com/z-shell//pull/123 + validations: + required: false + - type: dropdown + id: status + attributes: + label: Status + options: + - Planned + - In progress + - Blocked + - Ready for review + - Complete + validations: + required: true + - type: textarea + id: current-state + attributes: + label: Current state + description: What is true now? Include completed work and important decisions. + placeholder: | + - ... + validations: + required: true + - type: textarea + id: verification + attributes: + label: Verification + description: Commands, checks, CI runs, or review performed. Say "Not run" if nothing was run. + placeholder: | + - automation/ci/trunk-safe-check.sh -- check --no-fix: passed + - CI: pending + validations: + required: true + - type: textarea + id: blockers + attributes: + label: Blockers + description: Anything preventing completion. Write "None" if unblocked. + placeholder: None + validations: + required: true + - type: textarea + id: next-steps + attributes: + label: Next steps + description: Exact next actions for a fresh maintainer or agent. + placeholder: | + 1. ... + 2. ... + validations: + required: true + - type: textarea + id: links + attributes: + label: Links + description: Related issues, pull requests, tracker items, CI runs, or wiki pages. + placeholder: | + - ... + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/07_delivery_initiative.yml b/.github/ISSUE_TEMPLATE/07_delivery_initiative.yml new file mode 100644 index 000000000..3be6a322b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/07_delivery_initiative.yml @@ -0,0 +1,70 @@ +name: "Delivery initiative" +description: >- + Coordinate a cross-repository outcome through native sub-issues. +title: "[initiative]: " +labels: + - "type:maintenance" + - "area:meta" + - "status:triage" + - "meta:initiative" + - "meta:org-tracked" +body: + - type: markdown + attributes: + value: | + Use this form only for one coordinated outcome with at least two + independently deliverable issues in different repositories. After + creating the parent, create or connect each deliverable as a native + sub-issue. Follow the [sub-issues runbook](https://github.com/z-shell/.github/blob/main/runbooks/sub-issues.md). + - type: textarea + id: outcome + attributes: + label: Outcome + description: >- + State the coordinated result and who benefits when it is complete. + placeholder: One observable outcome, not a topic or task list. + validations: + required: true + - type: textarea + id: context + attributes: + label: Context + description: >- + Explain why the outcome matters and why coordination is needed now. + validations: + required: true + - type: textarea + id: deliverables + attributes: + label: Expected deliverables + description: >- + Name the independently deliverable results and their owning + repositories. Connect their issues as native sub-issues after creating + this parent. + placeholder: | + - z-shell/: + - z-shell/: + validations: + required: true + - type: textarea + id: dependencies + attributes: + label: Dependencies and risks + description: >- + Identify known blockers or execution order. Use native issue + dependencies after the related issues exist. + placeholder: None known. + validations: + required: true + - type: textarea + id: completion + attributes: + label: Completion criteria + description: >- + State how maintainers will verify the coordinated outcome before + closing this parent. + placeholder: | + - [ ] Observable outcome verified + - [ ] Required deliverables complete or explicitly descoped + validations: + required: true