mirror of
https://github.com/docker-mailserver/docker-mailserver.git
synced 2024-01-19 02:48:50 +00:00
ci: Simplify GH bug report template (#3381)
Simplify the bug report form further by dropping / merging form sections. Change Overview: - Minor revisions and formatting changes (_multi-line pipe operator, emoji, fix typos, etc_). - Collapsed OS + Arch into single input field (_not much benefit from the two additional dropdown items_). - Description/reproduction and expectation sections revised (_expectation intent is typically inferred by the issue description, while detailed reproduction steps can belong a separate optional section_). - Removed platform dropdown (_Windows and macOS are mentioned in description as unsupported_). - Removed experience checkboxes (_context doesn't really change responses_). - Removed the orchestrator dropdown (_we don't seem to use this information, it's just noise_) - Relocate the DMS version + OS/Arch sections to come after the Reproduction steps.
This commit is contained in:
parent
86e18d04dd
commit
e68062282a
120
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
120
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
|
@ -1,5 +1,5 @@
|
||||||
name: Bug Report
|
name: Bug Report
|
||||||
description: File a bug report
|
description: Submit a bug report to help us improve
|
||||||
title: 'bug report: '
|
title: 'bug report: '
|
||||||
labels:
|
labels:
|
||||||
- kind/bug/report
|
- kind/bug/report
|
||||||
|
@ -9,7 +9,7 @@ body:
|
||||||
- type: checkboxes
|
- type: checkboxes
|
||||||
id: preliminary-checks
|
id: preliminary-checks
|
||||||
attributes:
|
attributes:
|
||||||
label: Preliminary Checks
|
label: 📝 Preliminary Checks
|
||||||
description: Please read these carefully.
|
description: Please read these carefully.
|
||||||
options:
|
options:
|
||||||
- label: I checked that all ports are open and not blocked by my ISP / hosting provider.
|
- label: I checked that all ports are open and not blocked by my ISP / hosting provider.
|
||||||
|
@ -19,111 +19,65 @@ body:
|
||||||
- label: I searched the issue tracker but was unable to find my issue.
|
- label: I searched the issue tracker but was unable to find my issue.
|
||||||
required: true
|
required: true
|
||||||
- label: |
|
- label: |
|
||||||
I read
|
I have read:
|
||||||
|
- The [extended documentation in general](https://docker-mailserver.github.io/docker-mailserver/latest/) but found nothing to resolve the issue;
|
||||||
- the [extended documentation in general](https://docker-mailserver.github.io/docker-mailserver/latest/) but found nothing to resolve the issue;
|
- The [documentation on debugging](https://docker-mailserver.github.io/docker-mailserver/latest/config/debugging/), tried the proposed steps to debug the problem, but was still unable to resolve the issue;
|
||||||
- the [documentation on debugging](https://docker-mailserver.github.io/docker-mailserver/latest/config/debugging/), tried the proposed steps to debug the problem, but was still unable to resolve the issue;
|
- This project's [Code of Conduct](https://github.com/docker-mailserver/docker-mailserver/blob/master/CODE_OF_CONDUCT.md) and I agree;
|
||||||
- this project's [Code of Conduct](https://github.com/docker-mailserver/docker-mailserver/blob/master/CODE_OF_CONDUCT.md) and I agree;
|
- The [documentation about filing a bug report](https://docker-mailserver.github.io/docker-mailserver/latest/contributing/issues-and-pull-requests/#filing-a-bug-report).
|
||||||
- the [documentation about filing a bug report](https://docker-mailserver.github.io/docker-mailserver/latest/contributing/issues-and-pull-requests/#filing-a-bug-report).
|
|
||||||
required: true
|
required: true
|
||||||
- type: dropdown
|
- type: textarea
|
||||||
id: operating-system
|
id: what-happened
|
||||||
attributes:
|
attributes:
|
||||||
label: What operating system is the host running?
|
label: 👀 What Happened?
|
||||||
options:
|
description: How did this differ from your expectations?
|
||||||
- Linux
|
placeholder: Although `LOG_LEVEL=debug` is set, the logs are missing debug output.
|
||||||
- macOS (not officially supported)
|
|
||||||
- Windows (unsupported)
|
|
||||||
- Other (unsupported)
|
|
||||||
validations:
|
validations:
|
||||||
required: true
|
required: true
|
||||||
- type: input
|
- type: textarea
|
||||||
id: operating-system-version
|
id: steps-to-reproduce
|
||||||
attributes:
|
attributes:
|
||||||
label: Which operating system version?
|
label: 👟 Reproduction Steps
|
||||||
placeholder: Debian 11 (Bullseye)
|
description: |
|
||||||
validations:
|
How did you trigger this bug? Please walk us through it step by step.
|
||||||
required: true
|
Please use [fenced code blocks](https://docs.github.com/en/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks#fenced-code-blocks) when pasting lots of text!
|
||||||
- type: dropdown
|
placeholder: The easier it is for us to reproduce your issue, the sooner we can help resolve it 😉
|
||||||
id: isa
|
|
||||||
attributes:
|
|
||||||
label: What computer architecture is the host running?
|
|
||||||
options:
|
|
||||||
- AMD64 (x86_64)
|
|
||||||
- ARM64 (AArch64)
|
|
||||||
- Other (unsupported)
|
|
||||||
validations:
|
|
||||||
required: true
|
|
||||||
- type: dropdown
|
|
||||||
id: container-orchestrator
|
|
||||||
attributes:
|
|
||||||
label: What container orchestration tool are you using?
|
|
||||||
options:
|
|
||||||
- Docker
|
|
||||||
- Docker Compose
|
|
||||||
- Podman (not officially supported)
|
|
||||||
- Kubernetes (not officially supported)
|
|
||||||
- Other (unsupported)
|
|
||||||
validations:
|
|
||||||
required: true
|
|
||||||
- type: input
|
- type: input
|
||||||
id: mailserver-version
|
id: mailserver-version
|
||||||
attributes:
|
attributes:
|
||||||
label: DMS version
|
label: 🐋 DMS Version
|
||||||
description: On which version (image tag) did you encounter this bug?
|
description: On which version (image tag) did you encounter this bug?
|
||||||
placeholder: v12.1.0
|
placeholder: v12.1.0
|
||||||
validations:
|
validations:
|
||||||
required: true
|
required: true
|
||||||
- type: textarea
|
- type: input
|
||||||
id: when-does-it-occur
|
id: operating-system
|
||||||
attributes:
|
attributes:
|
||||||
label: What happened and when does this occur?
|
label: 💻 Operating System and Architecture
|
||||||
description: >
|
description: |
|
||||||
Tell us what happened.
|
Which OS is your docker host running on?
|
||||||
**It would also help immensely if you can share precise steps on how to reproduce the issue!** :heart:
|
**NOTE:** Windows and macOS have limited support.
|
||||||
Use [fenced code blocks](https://docs.github.com/en/github/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks#fenced-code-blocks) when pasting lots of text!
|
placeholder: Debian 11 (Bullseye) x86_64, Fedora 38 ARM64
|
||||||
placeholder: Although `LOG_LEVEL=debug` is set, I see no debug output.
|
|
||||||
validations:
|
|
||||||
required: true
|
|
||||||
- type: textarea
|
|
||||||
id: what-did-you-expect-to-happen
|
|
||||||
attributes:
|
|
||||||
label: What did you expect to happen?
|
|
||||||
description: Tell us what you expected.
|
|
||||||
placeholder: I expected to see debug messages.
|
|
||||||
validations:
|
validations:
|
||||||
required: true
|
required: true
|
||||||
- type: textarea
|
- type: textarea
|
||||||
id: container-configuration-files
|
id: container-configuration-files
|
||||||
attributes:
|
attributes:
|
||||||
label: Container configuration files
|
label: ⚙️ Container configuration files
|
||||||
description: >
|
description: |
|
||||||
Show us the file that you use to run DMS (and possibly other related services).
|
Show us the file that you use to run DMS (and possibly other related services).
|
||||||
This is most likely your `compose.yaml` file, but you can also show us your equivalent `docker run` command, if applicable. If you are using Kubernetes, you can also put your manifest files here.
|
- This field is formatted as YAML.
|
||||||
This filed is formatted as YAML.
|
- This is most likely your `compose.yaml` file, but you can also show us your equivalent `docker run` command, if applicable.
|
||||||
|
- If you are using Kubernetes, you can also put your manifest files here.
|
||||||
render: yml
|
render: yml
|
||||||
- type: textarea
|
- type: textarea
|
||||||
id: relevant-log-output
|
id: relevant-log-output
|
||||||
attributes:
|
attributes:
|
||||||
label: Relevant log output
|
label: 📜 Relevant log output
|
||||||
description: Show us relevant log output here. You can enable debug output by setting the environment variable `LOG_LEVEL` to `debug` or `trace`. This field's contents are interpreted as pure text.
|
description: |
|
||||||
|
Show us relevant log output here.
|
||||||
|
- This field expects only plain text (_rendered as a fenced code block_).
|
||||||
|
- You can enable debug output by setting the environment variable `LOG_LEVEL` to `debug` or `trace`.
|
||||||
render: Text
|
render: Text
|
||||||
- type: checkboxes
|
|
||||||
id: experience
|
|
||||||
attributes:
|
|
||||||
label: What level of experience do you have with containers, mail servers, and using a terminal?
|
|
||||||
description: >
|
|
||||||
**You are not obliged to answer this question**.
|
|
||||||
We do encourage answering though as it provides context to better assist you.
|
|
||||||
Less experienced users tend to make common mistakes, which is ok; by letting us know we can spot those more easily. If you are experienced, we can skip basic questions and save time.
|
|
||||||
|
|
||||||
options:
|
|
||||||
- label: I am inexperienced with containers
|
|
||||||
- label: I am rather experienced with containers
|
|
||||||
- label: I am inexperienced with mail servers
|
|
||||||
- label: I am rather experienced with mail servers
|
|
||||||
- label: I am uncomfortable with using a terminal (CLI)
|
|
||||||
- label: I am rather comfortable with using a terminal (CLI)
|
|
||||||
- type: input
|
- type: input
|
||||||
id: form-improvements
|
id: form-improvements
|
||||||
attributes:
|
attributes:
|
||||||
|
|
Loading…
Reference in a new issue