Add bug issue templates (#758)#784
Conversation
| value: | | ||
| ## This issue tracker is only for technical issues related to Payjoin Dev Kit. | ||
|
|
There was a problem hiding this comment.
Bitcoin Core's bug template has mentions of where to go for other issues (namely security & general questions/support) here. I think it would be good for us to have those as well, but I wanted to submit the most helpful template first. I think it would also be helpful to add "Good First Issue" template and "Feature Request" templates, all of which can be easily adapted from Bitcoin Core.
Regarding SECURITY.md, I'd need clarification on what info should go there if we're ready to do that. Payjoin seems like an important project to have that in but perhaps we want to have formal security reviews first.
When I do the SECURITY.md file, I'll put that and CONTRIBUTING.md in the root of the repo as initially requested, and to match Bitcoin Core.
Pull Request Test Coverage Report for Build 15933192835Details
💛 - Coveralls |
.github/ISSUE_TEMPLATE/bug.yml
Outdated
| Run `payjoin-cli --version` or `payjoin-directory --version` for the binaries. | ||
| For the library crates (`payjoin`, `payjoin-test-utils`, and `payjoin-ffi`), | ||
| check your respective package manager file to see which version you have installed. | ||
| placeholder: e.g. payjoin-0.23.0 or master@ceef77b |
There was a problem hiding this comment.
I could use clarifications on the best wording to put here.
5ac90a7 to
74ea1f9
Compare
bug.yml issue templatebug.yml issue template (#758)
nothingmuch
left a comment
There was a problem hiding this comment.
Perhaps we should split this up into two bug templates, one for the payjoin crate, and one for everything else?
For the payjoin crate I think we want to know whether they're using FFI, and if so what host language, etc, what features flags they enabled on the crate, and the rust version.
For everything else, i think what primarily matters whether or not they built it themselves (and if so with what features) or if they're using a binary release or the docker image, and perhaps information about the machine or environment, but I suspect that most issues would be for the payjoin crate where that information is far less likely to be relevant.
|
Oops I meant to post a comment review, not request changes since I didn't make concrete suggestions. |
Great points, I can modify it to have one for the payjoin crate and one for the others |
61351cb to
9f403f1
Compare
ec8426e to
dda9cb4
Compare
bug.yml issue template (#758)ca61fac to
ac3c9a4
Compare
Copied and made modifications to Bitcoin Core's [bug](https://github.com/bitcoin/bitcoin/blob/master/.github/ISSUE_TEMPLATE/bug.yml) issue template where appropriate initially. At @nothingmuch's suggestion, split this into two issue templates: - `bug-payjoin-crate.yml`, for issues relating to the `payjoin` crate - `bug-general.yml` for all other issues for other crates The former focuses on knowing whether the user is using FFI, includes a dropdown for language choice, asks what feature flags are enabled, etc. The latter focuses more on how they obtained it (binary, compiled from source, etc.) and information about the environment.
ac3c9a4 to
5678a18
Compare
|
@nothingmuch I split this into two as you suggested. One for the |
nothingmuch
left a comment
There was a problem hiding this comment.
ACK
I opened a new issue for the log question, I don't think it should block merging of this.
| description: | | ||
| Please copy and paste any relevant log output. This can be enabled by prefixing `RUST_LOG=debug cargo run ...` | ||
|
|
||
| Please be aware that the log might contain personally identifying information. |
There was a problem hiding this comment.
My main concern with this is that users might not understand the privacy consequences of certain log messages, maybe it's better to suggest info instead of debug until we've scrubbed those, and to warn specifically against trace which is not safe?
Also the RUST_LOG suggestion seems to apply to the tools crates too?
There was a problem hiding this comment.
My main concern with this is that users might not understand the privacy consequences of certain log messages, maybe it's better to suggest info instead of debug until we've scrubbed those, and to warn specifically against trace which is not safe?
I like that suggestion and can modify that in a subsequent PR
Also the RUST_LOG suggestion seems to apply to the tools crates too?
I like this idea but not all crates are setup with logs. For example payjoin-directory does not output logs when prefixed this way, its' behavior is unmodified
There was a problem hiding this comment.
I like this idea but not all crates are setup with logs. For example payjoin-directory does not output logs when prefixed this way, its' behavior is unmodified
Hmm, are you sure? trace level outputs are definitely there, there's not many debug level calls though i think only a serve_payjoin_directory
There was a problem hiding this comment.
Hmm, are you sure? trace level outputs are definitely there, there's not many debug level calls though i think only a serve_payjoin_directory
Ah, it appears I was tricked into this by not seeing any output when I used DEBUG (from this issue). My mistake.
I'm in favor (sorry for leaving this question in the merge commit message) |
Copies and makes modifications to Bitcoin Core's [bug](https://github.com/bitcoin/bitcoin/blob/master/.github/ISSUE_TEMPLATE/bug.yml) issue template where appropriate. If we'd like I'll make a PR containing the following templates next. This does not take long and with the exception of SECURITY.md can mostly be adapted from [Bitcoin Core](https://github.com/bitcoin/bitcoin/issues/new/choose): - [ ] [Feature Request](https://github.com/bitcoin/bitcoin/blob/master/.github/ISSUE_TEMPLATE/feature_request.yml) - [ ] [SECURITY.md](https://github.com/bitcoin/bitcoin/blob/master/SECURITY.md) - [ ] [Good First Issue](https://github.com/bitcoin/bitcoin/blob/master/.github/ISSUE_TEMPLATE/good_first_issue.yml) - [ ] General Question / Support
Copies and makes modifications to Bitcoin Core's
bug issue template where appropriate.
If we'd like I'll make a PR containing the following templates next. This does not take long and with the exception of SECURITY.md can mostly be adapted from Bitcoin Core: