docs: rework the bug report template

* move `id: can-reproduce` to first position to give incentivize reproducers.
  If the description comes first, the person filing the bug report
  will describe the problem in plain English. It is better if the
  first thing they do, if at all possible, is to create a reproducer
  and provide a link.
* remove `id: screenshots` as they can be copy/pasted to the
  description when relevant. They are more important int the UI
  bug report template but not so much here.
* remove `id: git-ver` as it is almost never relevant. If it is, this
  can be included in the description but clutters the template most of
  the time.
* remove `id: os-ver` as it is redundant with what `id: run-info`
  requires.
* dev.next.forgejo.org is running the latest development branch
* link to dev.next.forgejo.org instead of next.forgejo.org
This commit is contained in:
Earl Warren 2024-07-15 15:49:44 +02:00
parent af4b32aece
commit 38e91fc76f
No known key found for this signature in database
GPG key ID: 0579CB2928A78A00

View file

@ -13,14 +13,26 @@ body:
- Please speak English, as this is the language all maintainers can speak and write. - Please speak English, as this is the language all maintainers can speak and write.
- Be as clear and concise as possible. A very verbose report is harder to interpret in a concrete way. - Be as clear and concise as possible. A very verbose report is harder to interpret in a concrete way.
- Be civil, and follow the [Forgejo Code of Conduct](https://codeberg.org/forgejo/code-of-conduct). - Be civil, and follow the [Forgejo Code of Conduct](https://codeberg.org/forgejo/code-of-conduct).
- Please make sure you are using the latest release of Forgejo and take a moment to [check that your issue hasn't been reported before](https://codeberg.org/forgejo/forgejo/issues?q=&type=all&labels=78137). - Take a moment to [check that your issue hasn't been reported before](https://codeberg.org/forgejo/forgejo/issues?q=&type=all&labels=78137).
- Please give all relevant information below for bug reports, as incomplete details may result in the issue not being considered. - type: dropdown
id: can-reproduce
attributes:
label: Can you reproduce the bug on the Forgejo test instance?
description: |
Please try reproducing your issue at https://dev.next.forgejo.org.
It is running the latest development branch and will confirm the problem is not already fixed.
If you can reproduce it, provide a URL in the description.
options:
- "Yes"
- "No"
validations:
required: true
- type: textarea - type: textarea
id: description id: description
attributes: attributes:
label: Description label: Description
description: | description: |
Please provide a description of your issue here, with a URL if you were able to reproduce the issue (see below). Please provide a description of your issue here, with a URL if you were able to reproduce the issue (see above).
validations: validations:
required: true required: true
- type: input - type: input
@ -28,18 +40,14 @@ body:
attributes: attributes:
label: Forgejo Version label: Forgejo Version
description: Forgejo version (or commit reference) of your instance description: Forgejo version (or commit reference) of your instance
validations: - type: textarea
required: true id: run-info
- type: dropdown
id: can-reproduce
attributes: attributes:
label: Can you reproduce the bug on Forgejo Next? label: How are you running Forgejo?
description: | description: |
Please try reproducing your issue at [Forgejo Next](https://next.forgejo.org). Please include information on whether you built Forgejo yourself, used one of our downloads, or are using some other package.
If you can reproduce it, please provide a URL in the Description field. Please also tell us how you are running Forgejo, e.g. if it is being run from a container, a command-line, systemd etc.
options: If you are using a package or systemd tell us what distribution you are using.
- "Yes"
- "No"
validations: validations:
required: true required: true
- type: textarea - type: textarea
@ -53,31 +61,6 @@ body:
Please copy and paste your logs here, with any sensitive information (e.g. API keys) removed/hidden. Please copy and paste your logs here, with any sensitive information (e.g. API keys) removed/hidden.
You can wrap your logs in `<details>...</details>` tags so it doesn't take up too much space in the issue. You can wrap your logs in `<details>...</details>` tags so it doesn't take up too much space in the issue.
- type: textarea
id: screenshots
attributes:
label: Screenshots
description: If this issue involves the Web Interface, please provide one or more screenshots
- type: input
id: git-ver
attributes:
label: Git Version
description: The version of git running on the server
- type: input
id: os-ver
attributes:
label: Operating System
description: The operating system you are using to run Forgejo
- type: textarea
id: run-info
attributes:
label: How are you running Forgejo?
description: |
Please include information on whether you built Forgejo yourself, used one of our downloads, or are using some other package.
Please also tell us how you are running Forgejo, e.g. if it is being run from docker, a command-line, systemd etc.
If you are using a package or systemd tell us what distribution you are using.
validations:
required: true
- type: dropdown - type: dropdown
id: database id: database
attributes: attributes: