You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
19
18
- type: textarea
@@ -22,12 +21,6 @@ body:
22
21
description: Clearly describe what you were trying to do when you found this bug.
23
22
validations:
24
23
required: true
25
-
- type: textarea
26
-
attributes:
27
-
label: Why were you trying to do this?
28
-
description: Explain why you were trying to do this.
29
-
validations:
30
-
required: true
31
24
- type: textarea
32
25
attributes:
33
26
label: How did you attempt to do it?
@@ -50,17 +43,23 @@ body:
50
43
attributes:
51
44
label: How can we reproduce the issue?
52
45
description: |
53
-
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.
54
-
55
-
> 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.
46
+
📣 _This is a very important part of your report._
56
47
57
-
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.
48
+
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 provide links to) any PDFs, images, or other files necessary to run your code.
58
49
59
-
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).
50
+
Your code example should be a [SSCCE](http://www.sscce.org/):
51
+
- Short (Small) - Don't include code that is irrelevant or unnecessary.
52
+
- Self Contained - Ensure everything is included, ready to go.
53
+
- Correct - No additional code or changes are needed to copy, paste, and execute it.
54
+
- Example - Demonstrates the problem you are reporting.
60
55
61
-
> 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! 💖
56
+
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.
62
57
63
-
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.
58
+
> 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.
59
+
60
+
⚠️ 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.
61
+
62
+
💖 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!
64
63
validations:
65
64
required: true
66
65
- type: input
@@ -83,15 +82,11 @@ body:
83
82
required: true
84
83
- type: checkboxes
85
84
attributes:
86
-
label: Required Reading
85
+
label: Checklist
87
86
options:
88
-
- label: I have read [www.sscce.org](http://www.sscce.org/).
89
-
required: true
90
87
- label: My report includes a Short, Self Contained, Correct (Compilable) Example.
91
88
required: true
92
-
- label: I have read [Smart Questions](http://catb.org/~esr/faqs/smart-questions.html).
93
-
required: true
94
-
- label: I have read [45 GitHub Issues Dos and Don'ts](https://davidwalsh.name/45-github-issues-dos-donts).
89
+
- label: I have attached all PDFs, images, and other files needed to run my SSCCE.
0 commit comments