mirror of
				https://github.com/matrix-org/synapse.git
				synced 2025-10-31 12:18:24 +00:00 
			
		
		
		
	Use a GitHub form for issues rather than a hard-to-read, easy-to-ignore template. (#12982)
Co-authored-by: Brendan Abolivier <babolivier@matrix.org>
This commit is contained in:
		
							parent
							
								
									67f51c84f8
								
							
						
					
					
						commit
						3c8f1290b8
					
				
							
								
								
									
										72
									
								
								.github/ISSUE_TEMPLATE/BUG_REPORT.md
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										72
									
								
								.github/ISSUE_TEMPLATE/BUG_REPORT.md
									
									
									
									
										vendored
									
									
								
							| @ -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. | ||||
| --> | ||||
							
								
								
									
										103
									
								
								.github/ISSUE_TEMPLATE/BUG_REPORT.yml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										103
									
								
								.github/ISSUE_TEMPLATE/BUG_REPORT.yml
									
									
									
									
										vendored
									
									
										Normal file
									
								
							| @ -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? | ||||
							
								
								
									
										1
									
								
								changelog.d/12982.misc
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										1
									
								
								changelog.d/12982.misc
									
									
									
									
									
										Normal file
									
								
							| @ -0,0 +1 @@ | ||||
| Use a GitHub form for issues rather than a hard-to-read, easy-to-ignore template. | ||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user