Skip to content

Commit 31d05be

Browse files
authored
Update bug-report.md
1 parent ec8e45b commit 31d05be

File tree

1 file changed

+20
-31
lines changed

1 file changed

+20
-31
lines changed

.github/ISSUE_TEMPLATE/bug-report.md

Lines changed: 20 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -5,42 +5,32 @@ about: Tell us about uncompyle6 bugs
55
---
66

77
<!-- __Note:__ If you are using this program to do something illegal - don't.
8-
The issue may be flagged to make it easier for those looking for illegal activity.
8+
The issue may be flagged to make it easier for those seeking to report illegal activity.
99
1010
If you are reporting a bug in decompilation, it will probably not be acted upon
11-
unless it is narrowed to a small example. You may have to do some work remove
11+
unless it is narrowed to a small example. You may have to do some work to remove
1212
extraneous code from the source example. Most bugs can be expressed in 30 lines of
1313
code.
1414
15-
Issues are not for asking questions about a problem you
16-
are trying to solve that involve the use of uncompyle6 along the way,
17-
although I may be more tolerant of this if you sponsor the project.
15+
Issues are not for asking questions about a problem you are trying to solve that involves the use of uncompyle6 along the way, although I may be more tolerant of this if you sponsor the project.
1816
19-
Bugs are also not for general or novice kind help on how to install
17+
Bugs are also not for general or novice help on how to install
2018
this Python program and its dependencies in your environment, or in
2119
the way you would like to have it set up, or how to interpret a Python
22-
traceback e.g. that winds up saying Python X.Y.Z is not supported.
20+
traceback, e.g., that winds up saying Python X.Y.Z is not supported.
2321
24-
For these kinds of things, you will save yourself time by asking
25-
instead on forums like StackOverflow that are geared to helping people
26-
for such general or novice kinds questions and tasks. And unless you
27-
are a sponsor of the project, if your question seems to be of this
28-
category, the issue may just be closed.
22+
For these kinds of things, you will save yourself time by asking instead on forums like StackOverflow or ChatGPT that are geared to helping people with such general or novice kinds of questions and tasks. And unless you are a sponsor of the project, if your question seems to be of this category, the issue may just be closed.
2923
30-
Also, the unless you are a sponsor of the project, it may take a
24+
Also, unless you are a sponsor of the project, it may take a
3125
while, maybe a week or so, before the bug report is noticed, let alone
3226
acted upon.
3327
34-
To set expectations, some legitimate bugs can take years to fix, but
35-
they eventually do get fixed.
28+
To set expectations, some legitimate bugs can take years to fix, but most eventually do get fixed.
3629
37-
Funding the project was added to partially address the problem that there are
38-
lots of people seeking help and reporting bugs, but few people who are
30+
Funding the project was added to partially address the problem that there are lots of people seeking help and reporting bugs, but few people who are
3931
willing or capable of providing help or fixing bugs.
4032
41-
Tasks or the kinds of things others can do, but you can't do or don't
42-
want to do yourself are typically the kind of thing that you pay
43-
someone to do, especially when you are the primary beneficiary of the
33+
Tasks or the kinds of things others can do, but you can't do or don't want to do yourself, are typically the kind of thing that you pay someone to do, especially when you are the primary beneficiary of the
4434
work, or the task is complex, long, or tedious. If your code is over
4535
30 lines long, it fits into this category.
4636
@@ -57,13 +47,13 @@ Prerequisites/Caveats
5747
disassembler and produces valid results.
5848
* Try to make the bytecode that exhibits a bug as small as possible.
5949
* Don't put bytecode and corresponding source code on any service that
60-
requires registration to download. Instead attach it as a zip file.
61-
* When you open a bug report there is no privacy. If you need privacy, then
50+
requires registration to download. Instead, attach it as a zip file.
51+
* When you open a bug report, there is no privacy. If you need privacy, then
6252
contact me by email and explain who you are and the need for privacy.
6353
But be mindful that you may be asked to sponsor the project for the
6454
personal and private help that you are requesting.
6555
* If the legitimacy of the activity is deemed suspicious, I may flag it as suspicious,
66-
making the issue even more easy to detect.
56+
making the issue even easier to detect.
6757
6858
Bug reports that violate the above may be discarded.
6959
@@ -75,10 +65,9 @@ Bug reports that violate the above may be discarded.
7565

7666
## How to Reproduce
7767

78-
<!-- Please show both the *input* you gave and the
79-
output you got in describing how to reproduce the bug:
68+
<!-- Please show both the *input* you gave and the output you got in describing how to reproduce the bug.
8069
81-
or give a complete console log with input and output
70+
Or give a complete console log with input and output
8271
8372
```console
8473
$ uncompyle6 <command-line-options>
@@ -95,8 +84,8 @@ can add that too.
9584
## Output Given
9685

9786
<!--
98-
Please include not just the error message but all output leading to the message which includes echoing input and messages up to the error.
99-
For a command-line environment include command invocation and all the output produced.
87+
Please include not just the error message, but all output leading to the message, which includes echoing input and messages up to the error.
88+
For a command-line environment, include command invocation and all the output produced.
10089
10190
If this is too long, then try narrowing the problem to something short.
10291
-->
@@ -115,7 +104,7 @@ Please modify for your setup
115104
- Uncompyle6 version: output from `uncompyle6 --version` or `pip show uncompyle6`
116105
- xdis version: output from `pydisasm --version` or or `pip show xdis`
117106
- Python version for the version of Python the byte-compiled the file: `python -c "import sys; print(sys.version)"` where `python` is the correct CPython or PyPy binary.
118-
- OS and Version: [e.g. Ubuntu bionic]
107+
- OS and Version: [e.g., Ubuntu bionic]
119108
120109
-->
121110

@@ -125,8 +114,8 @@ Please modify for your setup
125114

126115
## Priority
127116

128-
<!-- If this is important for a particular public good state that here.
129-
If this is blocking some important activity let us know what activity it blocks.
117+
<!-- If this is important for a particular public good state it here.
118+
If this is blocking some important activity, let us know what activity it blocks.
130119
131120
Otherwise, we'll assume this has the lowest priority in addressing.
132121
-->

0 commit comments

Comments
 (0)