aboutsummaryrefslogtreecommitdiff
path: root/.github/ISSUE_TEMPLATE/bug_report.yml
diff options
context:
space:
mode:
authorOrestis Floros <orestisflo@gmail.com>2024-02-05 08:27:31 +0100
committerGitHub <noreply@github.com>2024-02-05 08:27:31 +0100
commit60cc6ce1743d242fc51421df6ba6fef461e24ee2 (patch)
tree9c2f560568ce67045b089fa488f733921afb2526 /.github/ISSUE_TEMPLATE/bug_report.yml
parentb9a796b24a8652de9029b82e974871512e880fad (diff)
downloadi3-60cc6ce1743d242fc51421df6ba6fef461e24ee2.tar.gz
i3-60cc6ce1743d242fc51421df6ba6fef461e24ee2.zip
Use new GitHub issue templates (#5900)
Biggest benefit is that the users are presented with a set of editable fields instead of having to edit markdown directly in a text box, which is less friendly. Links to userguide and IPC docs are clickable in the description. See https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository
Diffstat (limited to '.github/ISSUE_TEMPLATE/bug_report.yml')
-rwxr-xr-x.github/ISSUE_TEMPLATE/bug_report.yml107
1 files changed, 107 insertions, 0 deletions
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100755
index 00000000..734ab55b
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,107 @@
+name: Bug Report
+description: Create a report to help us improve.
+labels: [bug]
+body:
+ - type: checkboxes
+ id: terms
+ attributes:
+ label: Welcome
+ options:
+ - label: Yes, I'm using the latest major release or the current development version. These are the only supported versions.
+ required: true
+ - label: Yes, I've searched similar issues and discussions on GitHub and didn't find any.
+ required: true
+
+ - type: textarea
+ id: current
+ attributes:
+ label: Current Behavior
+ placeholder: |-
+ Describe the current behavior,
+ e.g., »When pressing Alt+j (focus left), the window above the current window is focused.«
+ validations:
+ required: true
+
+ - type: textarea
+ id: expected
+ attributes:
+ label: Expected Behavior
+ placeholder: |-
+ Describe the desired behavior you expect after mitigation of the issue,
+ e.g., »The window left next to the current window should be focused.«
+ validations:
+ required: true
+
+ - type: textarea
+ id: reproduction
+ attributes:
+ label: Reproduction Instructions
+ placeholder: |-
+ Please provide detailed instructions on how the bug can be reproduced.
+ E.g., »Open three windows in a V[A H[B C]] layout on a new workspace«
+ validations:
+ required: true
+
+ - type: textarea
+ id: version
+ attributes:
+ label: i3 version
+ description: |-
+ Paste the output of
+ ```
+ i3 --moreversion 2>&-
+ ```
+ render: text
+ validations:
+ required: true
+
+ - type: textarea
+ id: config
+ attributes:
+ label: Config file
+ description: |-
+ Please include your (complete) i3 config with which the issue occurs.
+
+ If you would like to help debugging the issue, please try to reduce the config such that it is as close to the default config as possible while still reproducing the issue. This can help us bisect the root cause.
+ render: text
+ validations:
+ required: true
+
+ - type: input
+ id: distro
+ attributes:
+ label: Linux distribution & Version
+ validations:
+ required: true
+
+ - type: dropdown
+ id: compositor
+ attributes:
+ label: Are you using a compositor?
+ description: |-
+ Try running
+ ```shell
+ pidof picom
+ pidof compton
+ ```
+ If any IDs show up, you are running a compositor
+ options:
+ - I don't know
+ - I am sure I don't run any compositor
+ - picom
+ - compton
+ - Other
+ validations:
+ required: true
+
+ - type: input
+ id: verbose-output
+ attributes:
+ label: Logfile
+ description: |-
+ Providing the URL to a logfile can help us trace the root cause of an issue much quicker. You can learn how to generate the logfile here:
+ https://i3wm.org/docs/debugging.html
+
+ Providing the logfile is optional.
+ validations:
+ required: false