diff --git a/.github/ISSUE_TEMPLATE/BUG_REPORT.md b/.github/ISSUE_TEMPLATE/BUG_REPORT.md
deleted file mode 100644
index 978b699886..0000000000
--- a/.github/ISSUE_TEMPLATE/BUG_REPORT.md
+++ /dev/null
@@ -1,72 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-
----
-
-<!--
-
-**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** (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
-filling out 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.
-
-Text between <!-- and --> marks will be invisible in the report.
-
--->
-
-### Description
-
-<!-- Describe here the problem that you are experiencing -->
-
-### Steps to reproduce
-
-- list the steps
-- that reproduce the bug
-- using hyphens as bullet points
-
-<!--
-Describe how what happens differs from what you expected.
-
-If you can identify any relevant log snippets from _homeserver.log_, please include
-those (please be careful to remove any personal or private data). Please surround them with
-``` (three backticks, on a line on their own), so that they are formatted legibly.
--->
-
-### Version information
-
-<!-- IMPORTANT: please answer the following questions, to help us narrow down the problem -->
-
-<!-- Was this issue identified on matrix.org or another homeserver? -->
-- **Homeserver**:
-
-If not matrix.org:
-
-<!--
- What version of Synapse is running?
-
-You can find the Synapse version 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.)
--->
-- **Version**:
-
-- **Install method**:
-<!-- examples: package manager/git clone/pip -->
-
-- **Platform**:
-<!--
-Tell us about the environment in which your homeserver is operating
-distro, hardware, if it's running in a vm/container, etc.
--->
diff --git a/.github/ISSUE_TEMPLATE/BUG_REPORT.yml b/.github/ISSUE_TEMPLATE/BUG_REPORT.yml
new file mode 100644
index 0000000000..1b304198bc
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/BUG_REPORT.yml
@@ -0,0 +1,103 @@
+name: Bug report
+description: Create a report to help us improve
+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 form. By following the instructions below and 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.
+ - 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.
+ - type: input
+ id: homeserver
+ attributes:
+ label: Homeserver
+ description: Which homeserver was this issue identified on? (matrix.org, another homeserver, etc)
+ validations:
+ required: true
+ - type: input
+ id: version
+ attributes:
+ label: Synapse Version
+ description: |
+ What version of Synapse is this homeserver running?
+
+ 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.)
+ validations:
+ required: true
+ - type: dropdown
+ id: install_method
+ 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.
+ validations:
+ required: true
+ - type: textarea
+ id: logs
+ 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
+ validations:
+ required: true
+ - type: textarea
+ id: anything_else
+ attributes:
+ label: Anything else that would be useful to know?
diff --git a/changelog.d/12982.misc b/changelog.d/12982.misc
new file mode 100644
index 0000000000..036b69efe6
--- /dev/null
+++ b/changelog.d/12982.misc
@@ -0,0 +1 @@
+Use a GitHub form for issues rather than a hard-to-read, easy-to-ignore template.
\ No newline at end of file
|
