mirror of
https://github.com/alacritty/alacritty.git
synced 2024-11-18 13:55:23 -05:00
Add new issue and PR templates
This adds a PR template that should remind users to document their changes in our CHANGELOG, without requiring too much direct interaction from the user. The issue template has also been reworked a bit, hopefully making it easier for people to report bugs, without intruding on them if the information is irrelevant or providing it is too much effort. Fixes #3031.
This commit is contained in:
parent
400d24f023
commit
918ce9dead
3 changed files with 29 additions and 36 deletions
25
.github/ISSUE_TEMPLATE.md
vendored
25
.github/ISSUE_TEMPLATE.md
vendored
|
@ -1,4 +1,25 @@
|
|||
Which operating system does the issue occur on?
|
||||
For bug reports, the following information can help speed up the process.
|
||||
|
||||
If on linux, are you using X11 or Wayland?
|
||||
Please describe the bug that you have found and what you would expect to happen instead.
|
||||
|
||||
# System
|
||||
|
||||
| | |
|
||||
|-------------------|-----------------------------------|
|
||||
| Operating System | [Linux/BSD/macOS/Windows] |
|
||||
| Alacritty Version | [`alacritty --version` output] |
|
||||
| Display Server | [X11/Wayland] (only on Linux) |
|
||||
| Window Manager | [i3/xfwm/...] (only on Linux) |
|
||||
| Compositor | [compton/...] (only on Linux) |
|
||||
| PTY Backend | [WinPTY/ConPTY] (only on Windows) |
|
||||
|
||||
# Logs
|
||||
|
||||
Based on the issue at hand, some logs might be relevant:
|
||||
|
||||
| Command | Issues |
|
||||
|----------------------------|-----------------------------------------------------|
|
||||
| STDOUT, STDERR | Crashes |
|
||||
| `alacritty -vv` | DPI, font size, resize, terminal grid and cell size |
|
||||
| `alacritty --print-events` | Problems with keyboard and keybindings |
|
||||
|
||||
|
|
6
.github/pull_request_template.md
vendored
Normal file
6
.github/pull_request_template.md
vendored
Normal file
|
@ -0,0 +1,6 @@
|
|||
Please make sure to document all user-facing changes in the `CANGELOG.md` file.
|
||||
|
||||
Please ensure the optional CI steps do not fail because of this PR.
|
||||
|
||||
Draft PRs are always welcome, though unless otherwise requested PRs will not be reviewed until CI is
|
||||
successful and they have left the draft stage.
|
|
@ -23,40 +23,6 @@ Bug reports should be reported in the [Alacritty issue tracker](https://github.c
|
|||
|
||||
If a bug was not present in a previous version of Alacritty, providing the exact commit which introduced the regression helps out a lot.
|
||||
|
||||
Since a multitude of operating systems are supported by Alacritty, not all issues might apply to every OS. So make sure to specify on which OS the bug has been found. Since Linux has a variety of window managers, compositors and display servers, please also specify those when encountering an issue on Linux.
|
||||
|
||||
Depending on the bug, it might also be useful to provide some of the following information:
|
||||
- Configuration file
|
||||
- `alacritty -v(vv)` output
|
||||
- `alacritty --print-events` output
|
||||
- `glxinfo` output
|
||||
- `xrandr` output
|
||||
|
||||
Here's a template that you can use to file a bug, though it's not necessary to use it exactly:
|
||||
|
||||
```
|
||||
# System
|
||||
| | |
|
||||
|------------------|-------------------------------|
|
||||
| Operating System | [Linux/BSD/macOS/Windows] |
|
||||
| Rust Version | [stable/beta/nightly/X.Y.Z] |
|
||||
| Display Server | [X11/Wayland] (only on Linux) |
|
||||
| Window Manager | [i3/xfwm/...] (only on Linux) |
|
||||
| Compositor | [compton/...] (only on Linux) |
|
||||
|
||||
# Summary
|
||||
[Short summary of the Bug]
|
||||
|
||||
# Behavior
|
||||
[Description of Alacritty's current behavior]
|
||||
|
||||
# Expectation
|
||||
[Description of expected behavior]
|
||||
|
||||
# Extra
|
||||
[Additional information like config or logs]
|
||||
```
|
||||
|
||||
## Patches / Pull Requests
|
||||
|
||||
All patches have to be sent on Github as [pull requests](https://github.com/jwilm/alacritty/pulls).
|
||||
|
|
Loading…
Reference in a new issue