Skip to content
This repository has been archived by the owner on Apr 26, 2024. It is now read-only.

Use a GitHub form for issues rather than a hard-to-read, easy-to-ignore template. #12982

Merged
merged 8 commits into from
Jun 8, 2022
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 0 additions & 72 deletions .github/ISSUE_TEMPLATE/BUG_REPORT.md

This file was deleted.

103 changes: 103 additions & 0 deletions .github/ISSUE_TEMPLATE/BUG_REPORT.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
name: Bug report
description: Create a report to help us improve
#labels: ["bug", "triage"]
reivilibre marked this conversation as resolved.
Show resolved Hide resolved
body:
- type: markdown
attributes:
value: |
**THIS IS NOT A SUPPORT CHANNEL!**
**IF YOU HAVE SUPPORT QUESTIONS ABOUT RUNNING OR CONFIGURING YOUR OWN HOME SERVER**,
please ask in **[#synapse:matrix.org](https://matrix.to/#/#synapse:matrix.org)** (using a matrix.org account if necessary).

If you want to report a security issue, please see https://matrix.org/security-disclosure-policy/

This is a bug report template. By following the instructions below and
reivilibre marked this conversation as resolved.
Show resolved Hide resolved
completing the sections with your information, you will help the us to get all
the necessary data to fix your issue.

You can also preview your report before submitting it. You may remove sections
that aren't relevant to your particular case.
reivilibre marked this conversation as resolved.
Show resolved Hide resolved
- type: textarea
id: description
attributes:
label: Description
description: Describe the problem that you are experiencing
validations:
required: true
- type: textarea
id: reproduction_steps
attributes:
label: Steps to reproduce
description: |
Describe the series of steps that leads you to the problem.

Describe how what happens differs from what you expected.
placeholder: Tell us what you see!
value: |
- list the steps
- that reproduce the bug
- using hyphens as bullet points
validations:
required: true
- type: markdown
attributes:
value: |
IMPORTANT: please answer the following questions, to help us narrow down the problem.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should probably have a line separator above it and a bit of emphasis on the text otherwise it looks like it applies to the previous item.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That better?

- type: input
id: homeserver
attributes:
label: Homeserver
description: Was this issue identified on matrix.org or another homeserver?
reivilibre marked this conversation as resolved.
Show resolved Hide resolved
validations:
required: true
- type: input
id: version
attributes:
label: Synapse Version
description: |
What version of Synapse is running?
reivilibre marked this conversation as resolved.
Show resolved Hide resolved

You can find the Synapse version by visiting https://yourserver.example.com/_matrix/federation/v1/version

or with this command:

```
$ curl http://localhost:8008/_synapse/admin/v1/server_version
```

(You may need to replace `localhost:8008` if Synapse is not configured to
listen on that port.)
reivilibre marked this conversation as resolved.
Show resolved Hide resolved
validations:
required: true
- type: dropdown
id: install_method
reivilibre marked this conversation as resolved.
Show resolved Hide resolved
attributes:
label: Installation Method
options:
- Docker (matrixdotorg/synapse)
- Debian packages from packages.matrix.org
- pip (from PyPI)
- Other (please mention below)
- type: textarea
id: platform
attributes:
label: Platform
description: |
Tell us about the environment in which your homeserver is operating...
e.g. distro, hardware, if it's running in a vm/container, etc.
- type: textarea
id: logs
reivilibre marked this conversation as resolved.
Show resolved Hide resolved
attributes:
label: Relevant log output
description: |
Please copy and paste any relevant log output, ideally at INFO or DEBUG log level.
This will be automatically formatted into code, so there is no need for backticks.

Please be careful to remove any personal or private data.

**Bug reports are usually very difficult to diagnose without logging.**
render: shell
- type: textarea
id: anything_else
attributes:
label: Anything else that would be useful to know?
1 change: 1 addition & 0 deletions changelog.d/12982.misc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Use a GitHub form for issues rather than a hard-to-read, easy-to-ignore template.