Skip to content

Commit da2501a

Browse files
authored
devops: update issue templates (microsoft#1474)
1 parent 7ce6c7f commit da2501a

9 files changed

Lines changed: 272 additions & 113 deletions

File tree

.github/ISSUE_TEMPLATE/bug.md

Lines changed: 0 additions & 64 deletions
This file was deleted.

.github/ISSUE_TEMPLATE/bug.yml

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
name: Bug Report 🪲
2+
description: Create a bug report to help us improve
3+
title: '[Bug]: '
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
# Please follow these steps first:
9+
- type: markdown
10+
attributes:
11+
value: |
12+
## Troubleshoot
13+
If Playwright is not behaving the way you expect, we'd ask you to look at the [documentation](https://playwright.dev/java/docs/intro) and search the issue tracker for evidence supporting your expectation.
14+
Please make reasonable efforts to troubleshoot and rule out issues with your code, the configuration, or any 3rd party libraries you might be using.
15+
Playwright offers [several debugging tools](https://playwright.dev/java/docs/debug) that you can use to troubleshoot your issues.
16+
- type: markdown
17+
attributes:
18+
value: |
19+
## Ask for help through appropriate channels
20+
If you feel unsure about the cause of the problem, consider asking for help on for example [StackOverflow](https://stackoverflow.com/questions/ask) or our [Discord channel](https://aka.ms/playwright/discord) before posting a bug report. The issue tracker is not a help forum.
21+
- type: markdown
22+
attributes:
23+
value: |
24+
## Make a minimal reproduction
25+
To file the report, you will need a GitHub repository with a minimal (but complete) example and simple/clear steps on how to reproduce the bug.
26+
The simpler you can make it, the more likely we are to successfully verify and fix the bug.
27+
- type: markdown
28+
attributes:
29+
value: |
30+
> [!IMPORTANT]
31+
> Bug reports without a minimal reproduction will be rejected.
32+
33+
---
34+
- type: input
35+
id: version
36+
attributes:
37+
label: Version
38+
description: |
39+
The version of Playwright you are using.
40+
Is it the [latest](https://github.com/microsoft/playwright-java/releases)? Test and see if the bug has already been fixed.
41+
placeholder: ex. 1.41.1
42+
validations:
43+
required: true
44+
- type: textarea
45+
id: reproduction
46+
attributes:
47+
label: Steps to reproduce
48+
description: Please link to a repository with a minimal reproduction and describe accurately how we can reproduce/verify the bug.
49+
placeholder: |
50+
Example steps (replace with your own):
51+
1. Clone my repo at https://github.com/<myuser>/example
52+
2. mvn test
53+
3. You should see the error come up
54+
validations:
55+
required: true
56+
- type: textarea
57+
id: expected
58+
attributes:
59+
label: Expected behavior
60+
description: A description of what you expect to happen.
61+
placeholder: I expect to see X or Y
62+
validations:
63+
required: true
64+
- type: textarea
65+
id: what-happened
66+
attributes:
67+
label: Actual behavior
68+
description: |
69+
A clear and concise description of the unexpected behavior.
70+
Please include any relevant output here, especially any error messages.
71+
placeholder: A bug happened!
72+
validations:
73+
required: true
74+
- type: textarea
75+
id: context
76+
attributes:
77+
label: Additional context
78+
description: Anything else that might be relevant
79+
validations:
80+
required: false
81+
- type: textarea
82+
id: envinfo
83+
attributes:
84+
label: Environment
85+
description: |
86+
Please provide information about the environment you are running in.
87+
placeholder: |
88+
- Operating System: [Ubuntu 22.04]
89+
- CPU: [arm64]
90+
- Browser: [All, Chromium, Firefox, WebKit]
91+
- Java Version: [20]
92+
- Maven Version: [3.8.6]
93+
- Other info:
94+
validations:
95+
required: true

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
blank_issues_enabled: false
12
contact_links:
23
- name: Join our Discord Server
34
url: https://aka.ms/playwright/discord
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
name: Documentation 📖
2+
description: Submit a request to add or update documentation
3+
title: '[Docs]: '
4+
labels: ['Documentation :book:']
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
### Thank you for helping us improve our documentation!
10+
Please be sure you are looking at [the Next version of the documentation](https://playwright.dev/java/docs/next/intro) before opening an issue here.
11+
- type: textarea
12+
id: links
13+
attributes:
14+
label: Page(s)
15+
description: |
16+
Links to one or more documentation pages that should be modified.
17+
If you are reporting an issue with a specific section of a page, try to link directly to the nearest anchor.
18+
If you are suggesting that a new page be created, link to the parent of the proposed page.
19+
validations:
20+
required: true
21+
- type: textarea
22+
id: description
23+
attributes:
24+
label: Description
25+
description: |
26+
Describe the change you are requesting.
27+
If the issue pertains to a single function or matcher, be sure to specify the entire call signature.
28+
validations:
29+
required: true

.github/ISSUE_TEMPLATE/feature.yml

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
name: Feature Request 🚀
2+
description: Submit a proposal for a new feature
3+
title: '[Feature]: '
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
### Thank you for taking the time to suggest a new feature!
9+
- type: textarea
10+
id: description
11+
attributes:
12+
label: '🚀 Feature Request'
13+
description: A clear and concise description of what the feature is.
14+
validations:
15+
required: true
16+
- type: textarea
17+
id: example
18+
attributes:
19+
label: Example
20+
description: Describe how this feature would be used.
21+
validations:
22+
required: false
23+
- type: textarea
24+
id: motivation
25+
attributes:
26+
label: Motivation
27+
description: |
28+
Outline your motivation for the proposal. How will it make Playwright better?
29+
validations:
30+
required: true

.github/ISSUE_TEMPLATE/feature_request.md

Lines changed: 0 additions & 11 deletions
This file was deleted.
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
name: 'Questions / Help 💬'
2+
description: If you have questions, please check StackOverflow or Discord
3+
title: '[Please read the message below]'
4+
labels: [':speech_balloon: Question']
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
## Questions and Help 💬
10+
11+
This issue tracker is reserved for bug reports and feature requests.
12+
13+
For anything else, such as questions or getting help, please see:
14+
15+
- [The Playwright documentation](https://playwright.dev/java)
16+
- [Our Discord server](https://aka.ms/playwright/discord)
17+
- type: checkboxes
18+
id: no-post
19+
attributes:
20+
label: |
21+
Please do not submit this issue.
22+
description: |
23+
> [!IMPORTANT]
24+
> This issue will be closed.
25+
options:
26+
- label: I understand
27+
required: true

.github/ISSUE_TEMPLATE/regression.md

Lines changed: 0 additions & 38 deletions
This file was deleted.
Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
name: Report regression
2+
description: Functionality that used to work and does not any more
3+
title: "[Regression]: "
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
# Please follow these steps first:
9+
- type: markdown
10+
attributes:
11+
value: |
12+
## Make a minimal reproduction
13+
To file the report, you will need a GitHub repository with a minimal (but complete) example and simple/clear steps on how to reproduce the regression.
14+
The simpler you can make it, the more likely we are to successfully verify and fix the regression.
15+
- type: markdown
16+
attributes:
17+
value: |
18+
> [!IMPORTANT]
19+
> Regression reports without a minimal reproduction will be rejected.
20+
21+
---
22+
- type: input
23+
id: goodVersion
24+
attributes:
25+
label: Last Good Version
26+
description: |
27+
Last version of Playwright where the feature was working.
28+
placeholder: ex. 1.40.1
29+
validations:
30+
required: true
31+
- type: input
32+
id: badVersion
33+
attributes:
34+
label: First Bad Version
35+
description: |
36+
First version of Playwright where the feature was broken.
37+
Is it the [latest](https://github.com/microsoft/playwright-java/releases)? Test and see if the regression has already been fixed.
38+
placeholder: ex. 1.41.1
39+
validations:
40+
required: true
41+
- type: textarea
42+
id: reproduction
43+
attributes:
44+
label: Steps to reproduce
45+
description: Please link to a repository with a minimal reproduction and describe accurately how we can reproduce/verify the bug.
46+
placeholder: |
47+
Example steps (replace with your own):
48+
1. Clone my repo at https://github.com/<myuser>/example
49+
2. mvn test
50+
3. You should see the error come up
51+
validations:
52+
required: true
53+
- type: textarea
54+
id: expected
55+
attributes:
56+
label: Expected behavior
57+
description: A description of what you expect to happen.
58+
placeholder: I expect to see X or Y
59+
validations:
60+
required: true
61+
- type: textarea
62+
id: what-happened
63+
attributes:
64+
label: Actual behavior
65+
description: A clear and concise description of the unexpected behavior.
66+
placeholder: A bug happened!
67+
validations:
68+
required: true
69+
- type: textarea
70+
id: context
71+
attributes:
72+
label: Additional context
73+
description: Anything else that might be relevant
74+
validations:
75+
required: false
76+
- type: textarea
77+
id: envinfo
78+
attributes:
79+
label: Environment
80+
description: |
81+
Please provide information about the environment you are running in.
82+
placeholder: |
83+
- Operating System: [Ubuntu 22.04]
84+
- CPU: [arm64]
85+
- Browser: [All, Chromium, Firefox, WebKit]
86+
- Java Version: [20]
87+
- Maven Version: [3.8.6]
88+
- Other info:
89+
validations:
90+
required: true

0 commit comments

Comments
 (0)