Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

feat: add issue templates, discussion templates, and PR template #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
psjamesp merged 1 commit into from
Apr 21, 2026
Merged

feat: add issue templates, discussion templates, and PR template #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions 18 .github/DISCUSSION_TEMPLATE/announcements.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
title: "[Announcement]: "
labels:
- announcement
body:
- type: markdown
attributes:
value: |
Use this template for official announcements: new releases, adoption news, governance changes, maintainer changes, or other org-wide updates.

Only maintainers and the Steward should post in this category. Community members can react and reply.

- type: textarea
id: announcement
attributes:
label: Announcement
description: The full announcement text. Include links to relevant issues, PRs, or releases.
validations:
required: true
16 changes: 16 additions & 0 deletions 16 .github/DISCUSSION_TEMPLATE/general.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
title: ""
labels: []
body:
- type: markdown
attributes:
value: |
This is the place for general conversation about PowerShellOrg and its projects.

For bug reports, use [Issues](../../issues/new/choose). For feature requests, use [Issues](../../issues/new/choose). For how-to questions, use the [Q&A category](../../discussions/new?category=q-a).

- type: textarea
id: discussion
attributes:
label: What's on your mind?
validations:
required: true
26 changes: 26 additions & 0 deletions 26 .github/DISCUSSION_TEMPLATE/ideas.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
title: "[Idea]: "
labels:
- idea
body:
- type: markdown
attributes:
value: |
Share an idea that is not yet ready for a formal feature request. This is a good place to get early feedback, gauge interest, and shape a proposal before opening an Issue.

If an idea gets strong support here, a maintainer may ask you to convert it into a Feature Request issue.

- type: textarea
id: idea
attributes:
label: The idea
description: Describe the idea and the problem it solves.
validations:
required: true

- type: textarea
id: context
attributes:
label: Why now / why this?
description: What prompted this idea? Is there a specific workflow or gap it addresses?
validations:
required: false
91 changes: 91 additions & 0 deletions 91 .github/ISSUE_TEMPLATE/bug_report.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
name: Bug Report
description: Report incorrect or unexpected behavior in a PowerShellOrg module.
title: "[Bug]: "
labels:
- bug
- needs-triage
body:
- type: markdown
attributes:
value: |
Thank you for taking the time to report a bug. Please fill in as much detail as you can — complete reports get triaged and fixed faster.

Before submitting, please [search existing issues](../../issues?q=is%3Aissue+label%3Abug) to avoid duplicates.

- type: dropdown
id: ps-version
attributes:
label: PowerShell Version
description: Which PowerShell version(s) does this affect?
options:
- "5.1 (Windows PowerShell)"
- "7.x (PowerShell Core)"
- "Both 5.1 and 7.x"
validations:
required: true

- type: dropdown
id: os
attributes:
label: Operating System
description: Which operating system(s) does this affect?
options:
- Windows
- Linux
- macOS
- All platforms
validations:
required: true

- type: input
id: module-version
attributes:
label: Module Version
description: Output of `(Get-Module ModuleName).Version` or the version listed in `Import-Module -Verbose`.
placeholder: "e.g., 2.1.3"
validations:
required: true

- type: textarea
id: what-happened
attributes:
label: What happened?
description: A clear and concise description of what the bug is. Include any error messages exactly as they appeared.
validations:
required: true

- type: textarea
id: expected
attributes:
label: Expected behavior
description: What did you expect to happen instead?
validations:
required: true

- type: textarea
id: repro
attributes:
label: Minimal reproduction
description: |
The smallest possible script that demonstrates the problem. Remove everything not needed to trigger the bug.
Tip: wrap sensitive values in variables — do not paste real credentials or tokens.
render: powershell
validations:
required: true

- type: textarea
id: logs
attributes:
label: Error output / logs
description: Paste any relevant error output, stack traces, or verbose logs here. This will be automatically formatted as code.
render: text
validations:
required: false

- type: textarea
id: additional-context
attributes:
label: Additional context
description: Anything else that might help — related issues, workarounds you have tried, recent changes to your environment.
validations:
required: false
14 changes: 14 additions & 0 deletions 14 .github/ISSUE_TEMPLATE/config.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
blank_issues_enabled: false

contact_links:
- name: Ask a question (GitHub Discussions)
url: https://github.com/PowerShellOrg/.github/discussions/new?category=q-a
about: Use Discussions for how-to questions. Issues are for bugs and feature requests only.

- name: Support guide
url: https://github.com/PowerShellOrg/.github/blob/main/.github/SUPPORT.md
about: Not sure where to go? Read our support guide first.

- name: Security vulnerability
url: https://github.com/PowerShellOrg/.github/blob/main/.github/SECURITY.md
about: Report a security issue privately — do NOT open a public issue.
59 changes: 59 additions & 0 deletions 59 .github/ISSUE_TEMPLATE/feature_request.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
name: Feature Request
description: Suggest a new feature or improvement for a PowerShellOrg module.
title: "[Feature]: "
labels:
- enhancement
- needs-triage
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to suggest an improvement. Before submitting, please [search existing issues and discussions](../../issues?q=is%3Aissue+label%3Aenhancement) to see if this has already been proposed.

For large or breaking changes, consider opening a Discussion first to get early feedback before investing time in a detailed proposal.

- type: textarea
id: problem
attributes:
label: Problem statement
description: |
What problem are you trying to solve? Describe the situation without assuming any particular solution.
Example: "When I have 50 dependency entries, I have no way to see which ones failed without parsing the verbose output manually."
validations:
required: true

- type: textarea
id: solution
attributes:
label: Proposed solution
description: Describe the feature or change you would like to see. Include proposed parameter names, output format, behavior, or API changes if applicable.
validations:
required: true

- type: textarea
id: alternatives
attributes:
label: Alternatives considered
description: What other approaches or workarounds have you tried or considered? Why do they fall short?
validations:
required: false

- type: dropdown
id: contribution
attributes:
label: Willing to contribute?
description: Would you be willing to open a pull request implementing this feature?
options:
- "Yes — I plan to open a PR"
- "Maybe — I could, with guidance"
- "No — I am requesting someone else implement this"
validations:
required: true

- type: textarea
id: additional-context
attributes:
label: Additional context
description: Links to related issues, prior art in other tools, screenshots, or anything else that helps illustrate the request.
validations:
required: false
41 changes: 41 additions & 0 deletions 41 .github/ISSUE_TEMPLATE/question.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
name: Question
description: Ask a question about using a PowerShellOrg module.
title: "[Question]: "
labels:
- question
body:
- type: markdown
attributes:
value: |
## Before you open an issue

**Questions are better asked in [GitHub Discussions](../../discussions/new?category=q-a).** Discussions are searchable, so your question and its answer can help future users. Issues are reserved for tracked bugs and feature requests.

If you have already checked Discussions and still need help, you are in the right place.

- type: textarea
id: question
attributes:
label: Your question
description: What are you trying to do, and what have you tried so far?
validations:
required: true

- type: input
id: module-version
attributes:
label: Module Version
placeholder: "e.g., 2.1.3"
validations:
required: false

- type: dropdown
id: ps-version
attributes:
label: PowerShell Version
options:
- "5.1 (Windows PowerShell)"
- "7.x (PowerShell Core)"
- "Not applicable"
validations:
required: false
Loading
Morty Proxy This is a proxified and sanitized view of the page, visit original site.