Skip to content

Commit

Permalink
Update bug.yml
Browse files Browse the repository at this point in the history
  • Loading branch information
Hopding authored Nov 6, 2021
1 parent 0a328c4 commit ee6f3d2
Showing 1 changed file with 16 additions and 23 deletions.
39 changes: 16 additions & 23 deletions .github/ISSUE_TEMPLATE/bug.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,14 @@ body:
- type: markdown
attributes:
value: |
Thanks for taking the time to submit a bug report!
Thanks for taking the time to submit a bug report! 😃
* Be sure to answer **all** of the questions below.
* Provide lots of detail. Too much info is better than not enough.
* If we can't reproduce the issue, we can't fix it.
Please help us help you by reading the following posts before submitting your report! 😃
* [www.sscce.org](http://www.sscce.org/)
* [Smart Questions](http://catb.org/~esr/faqs/smart-questions.html)
If you've never created an issue on GitHub before, you might find these links helpful:
* [45 GitHub Issues Dos and Don'ts](https://davidwalsh.name/45-github-issues-dos-donts)
* [Smart Questions](http://catb.org/~esr/faqs/smart-questions.html)
You can read [MAINTAINERSHIP.md](https://github.com/Hopding/pdf-lib/blob/master/docs/MAINTAINERSHIP.md) to learn more about how this repo is maintained.
- type: textarea
Expand All @@ -22,12 +21,6 @@ body:
description: Clearly describe what you were trying to do when you found this bug.
validations:
required: true
- type: textarea
attributes:
label: Why were you trying to do this?
description: Explain why you were trying to do this.
validations:
required: true
- type: textarea
attributes:
label: How did you attempt to do it?
Expand All @@ -50,17 +43,21 @@ body:
attributes:
label: How can we reproduce the issue?
description: |
Type out a list of specific steps we can take to reproduce the bug you've found. Your response must include both prose and code snippets. You must attach (or provides links to) any PDFs, images, or other files necessary to complete the steps.
> If you are unable to share certain files (e.g. confidential PDFs), then state this in your response. Be prepared to share the files privately (e.g. via email). If you are unable to do this then we probably can't fix the issue.
Your response should include **complete**, **executable** code, ideally in the form of a git repo. Read [www.sscce.org](http://www.sscce.org/) to learn how to create a Short, Self Contained, Correct (Compilable) Example.
Provide **complete**, **executable** code that can be used to reproduce the bug (e.g. a git repo, ZIP file, or JSFiddle). You must attach (or provides links to) any PDFs, images, or other files necessary to run your code.
Please also read [Smart Questions](http://catb.org/~esr/faqs/smart-questions.html) and [45 GitHub Issues Dos and Don'ts](https://davidwalsh.name/45-github-issues-dos-donts).
Your code example should be a [SSCCE](http://www.sscce.org/):
- Short (Small) - Don't include code that is irrelevant or unnecessary.
- Self Contained - Ensure everything is included, ready to go.
- Correct - No additional code or changes are needed to copy, paste, and execute it.
- Example - Displays the problem you are reporting.
> We understand this is a nontrivial amount of reading. However, it's important that you create a well-defined report in order to reduce the demand placed on maintainers trying to help you. We want to make this a pleasant, efficient process for both you and us! 💖
Please also type out a list of specific steps we can take to run your code and reproduce the issue. Depending on what you're reporting, this might be simple as running a JSFiddle or downloading a ZIP file and executing `node index.js`. Some issues will require more instructions.
If your response only includes incomplete code or doesn't clearly state how to execute the code you've provided, your report will be closed without comment.
> If you are unable to share certain files (e.g. confidential PDFs), then state this in your response. Be prepared to share the files privately (e.g. via email). If you are unable to do this then we probably can't fix the issue.
⚠️ If your response includes incomplete code or doesn't clearly state how to execute the code you've provided, your report will be closed without comment.

Thank you for taking the time to create a well-defined report. This helps reduce the demand placed on maintainers trying to help you. We want to make this a pleasant, efficient process for both you and us! 💖
validations:
required: true
- type: input
Expand All @@ -85,13 +82,9 @@ body:
attributes:
label: Required Reading
options:
- label: I have read [www.sscce.org](http://www.sscce.org/).
required: true
- label: My report includes a Short, Self Contained, Correct (Compilable) Example.
required: true
- label: I have read [Smart Questions](http://catb.org/~esr/faqs/smart-questions.html).
required: true
- label: I have read [45 GitHub Issues Dos and Don'ts](https://davidwalsh.name/45-github-issues-dos-donts).
- label: I have attached all PDFs, images, and fonts needed to run my SSCCE.
required: true
- type: textarea
attributes:
Expand Down

0 comments on commit ee6f3d2

Please sign in to comment.