Skip to content

Commit d629839

Browse files
michaeltlombardimichaeltlombardi
committed
(MAINT) Update GitHub templates
This change copies the default templates for PowerShell repositories and customizes them for DSC. In particular, the bug report template is updated to more usefully reflect errors and issues with DSC, rather than a PowerShell command. The change includes the feature request template and template config, because adding any files to the `.github/ISSUE_TEMPLATE` directory requires all of them to be present - none of the defaults in the community repository are used when this folder exists.
1 parent ef36815 commit d629839

File tree

3 files changed

+157
-0
lines changed

3 files changed

+157
-0
lines changed

‎.github/ISSUE_TEMPLATE/Bug_Report.yml‎

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
name: Bug report 🐛
2+
description: Report errors or unexpected behavior 🤔
3+
labels:
4+
- Issue-Bug
5+
- Need-Review
6+
body:
7+
- type: checkboxes
8+
attributes:
9+
label: Prerequisites
10+
options:
11+
- label: Write a descriptive title.
12+
required: true
13+
- label: Make sure you are able to repro it on the latest version
14+
required: true
15+
- label: Search the existing issues.
16+
required: true
17+
- type: textarea
18+
attributes:
19+
label: Summary
20+
description: >-
21+
Write a short description of the issue at a high-level.
22+
placeholder: >-
23+
I am experiencing a problem with X.
24+
I think Y should be happening but Z is actually happening.
25+
validations:
26+
required: true
27+
- type: textarea
28+
attributes:
29+
label: Steps to reproduce
30+
description: >
31+
List of steps, sample code, failing test or link to a project that reproduces the behavior.
32+
Make sure you place a stack trace inside a code (```) block to avoid linking unrelated issues.
33+
placeholder: |-
34+
1. Create the following configuration document:
35+
36+
```yaml
37+
# repro.dsc.config.yaml
38+
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2023/08/config/document.json
39+
resources:
40+
- name: repro
41+
type: Test/Echo
42+
properties:
43+
output: expected value
44+
```
45+
46+
1. Call the `get` operation on the repro document:
47+
48+
```sh
49+
dsc config get --path ./repro.dsc.config.yaml
50+
```
51+
validations:
52+
required: true
53+
- type: textarea
54+
attributes:
55+
label: Expected behavior
56+
render: console
57+
placeholder: |
58+
PS> dsc config get --path ./repro.dsc.config.yaml
59+
60+
results:
61+
- name: repro
62+
type: Test/Echo
63+
result:
64+
actualState:
65+
output: expected value
66+
messages: []
67+
hadErrors: false
68+
validations:
69+
required: true
70+
- type: textarea
71+
attributes:
72+
label: Actual behavior
73+
render: console
74+
placeholder: |
75+
PS> dsc config get --path ./repro.dsc.config.yaml
76+
77+
results:
78+
- name: repro
79+
type: Test/Echo
80+
result:
81+
actualState:
82+
output: other value
83+
messages: []
84+
hadErrors: false
85+
validations:
86+
required: true
87+
- type: textarea
88+
attributes:
89+
label: Error details
90+
description: Paste verbatim output from DSC if it returns an error
91+
render: console
92+
- type: textarea
93+
attributes:
94+
label: Environment data
95+
description: Paste verbatim output from `$PSVersionTable` below.
96+
render: PowerShell
97+
placeholder: PS> $PSVersionTable
98+
validations:
99+
required: true
100+
- type: dropdown
101+
validations:
102+
required: true
103+
attributes:
104+
label: Version
105+
description: >-
106+
Specify the version you're using. Run the `dsc --version` command to get
107+
the current version.
108+
options:
109+
- Latest build from `main`
110+
- alpha.5
111+
- alpha.4
112+
- alpha.3
113+
- alpha.2
114+
- alpha.1
115+
default: 1
116+
multiple: false
117+
118+
- type: textarea
119+
attributes:
120+
label: Visuals
121+
description: >
122+
Please upload images or animations that can be used to reproduce issues in the area below.
123+
Try the [Steps Recorder](https://support.microsoft.com/en-us/windows/record-steps-to-reproduce-a-problem-46582a9b-620f-2e36-00c9-04e25d784e47)
124+
on Windows or [Screenshot](https://support.apple.com/en-us/HT208721) on macOS.

‎.github/ISSUE_TEMPLATE/Feature_Request.yml‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
name: Feature Request / Idea 🚀
2+
description: >-
3+
Suggest a new feature or improvement (this doesn't mean you have to
4+
implement it)
5+
labels:
6+
- Issue-Enhancement
7+
- Needs Triage
8+
body:
9+
- type: textarea
10+
attributes:
11+
label: Summary of the new feature / enhancement
12+
description: >
13+
A clear and concise description of what the problem is that the
14+
new feature would solve. Try formulating it in user story style
15+
(if applicable).
16+
placeholder: >-
17+
'As a user I want X so that Y...' with X being the being the
18+
action and Y being the value of the action.
19+
validations:
20+
required: true
21+
22+
- type: textarea
23+
attributes:
24+
label: Proposed technical implementation details (optional)
25+
placeholder: >
26+
A clear and concise description of what you want to happen.
27+
Consider providing an example experience with expected result.

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: Ask a question
4+
url: https://github.com/PowerShell/DSC/discussions/new?category=q-a
5+
about: >-
6+
If you have a question about DSC, the docs, or this project, ask it here.

0 commit comments

Comments
 (0)