Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Proposal: Add templates for Issues and PRs #2611

Merged
merged 8 commits into from
Apr 16, 2022

Conversation

elenaf9
Copy link
Contributor

@elenaf9 elenaf9 commented Apr 7, 2022

This PR drafts a couple of templates for issues and pull-requests. I think these templates would help debugging reported bugs, and ease the reviews (e.g. not having to ask for a Changelog entry every single time 😄).
The templates are mostly copied from what I saw in other projects. I tried to keep them rather short but include all relevant sections. Happy to add more cases or drop individual templates. Also grateful for any suggestions for improvement of the proposed templates.
In case that anybody is opposed to adding templates I am happy to discuss it.

Copy link
Member

@mxinden mxinden left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Elena! Very good idea.

e.g. not having to ask for a Changelog entry every single time smile)

:D true that

@@ -0,0 +1,22 @@
---
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would guess that one can reformulate all enhancements as small feature requests. Thus, for the sake of simplicity, we could drop the enhancement template. Not a strong opinion.

Copy link
Contributor Author

@elenaf9 elenaf9 Apr 9, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about that as well. The reason why I decided to add it is because of issues like #2373, #2484 or #2393, which aren't really (small) features, but instead improvements/ changes in exiting features. Could also rename it to improvement / change / ...?, but enhancement is the common term in other repos.
But not a strong opinion on my side either, I am also okay with removing it.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 Let's keep it and see how often it is used.


<!-- For questions please use the rust-libp2p GitHub Discussions forum.-->

<!-- For security related issues please reach out to security@ipfs.io. Please do not file a public issue on GitHub. -->
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🙏


<!-- Thank you for filing a bug report! -->

<!-- For questions please use the rust-libp2p GitHub Discussions forum.-->
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could this be linked like discuss.libp2p.io in config.yaml?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea!

---

<!--
Note: If you'd like to suggest an feature related to libp2p but not specifically related to the rust implementation, please file an issue at https://github.com/libp2p/libp2p instead. Even better, create a new topic on the forums (https://discuss.libp2p.io).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Note: If you'd like to suggest an feature related to libp2p but not specifically related to the rust implementation, please file an issue at https://github.com/libp2p/libp2p instead. Even better, create a new topic on the forums (https://discuss.libp2p.io).
Note: If you'd like to suggest an feature related to libp2p but not specifically related to the rust implementation, please file an issue at https://github.com/libp2p/specs instead.

Is anyone still using libp2p/libp2p?

I would suggest we keep discuss.libp2p.io for helping folks. I would prefer any design work to happen on libp2p/specs.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I copied that part from the go-libp2p template: https://github.com/libp2p/go-libp2p/blob/e8d3df92f7a6f72475dcd028496be2c6923fcb3a/.github/ISSUE_TEMPLATE/feature.md?plain=1#L8 (cc @marten-seemann).
But keeping design work to a single place, that is libp2p/specs, sounds good to me.


## Are you planning to do it yourself in a pull request?

<!--Any contribution is greatly appreciated. We are more than happy to provide help on the process.-->
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is cool! I like emphasizing the fact that this project is open to external contributions.

.github/pull_request_template.md Outdated Show resolved Hide resolved
.github/pull_request_template.md Outdated Show resolved Hide resolved
.github/pull_request_template.md Outdated Show resolved Hide resolved
Copy link
Member

@mxinden mxinden left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the follow-ups!

@mxinden mxinden merged commit 0938638 into libp2p:master Apr 16, 2022
@elenaf9 elenaf9 deleted the github/templates branch April 17, 2022 14:01
@elenaf9
Copy link
Contributor Author

elenaf9 commented Apr 17, 2022

Somehow, the contact links are not shown when creating a new issue. I tested the same config in a dummy repo, but there it works as expected: https://github.com/elenaf9/test/issues/new/choose. I don't know why this is the case, is this something that could be suppressed by certain Repo settings?

@mxinden
Copy link
Member

mxinden commented Apr 22, 2022

Maybe @galargh knows more? Is this related to the libp2p Github organization?

@elenaf9
Copy link
Contributor Author

elenaf9 commented May 4, 2022

Oh, found the issue. I missed a typo: it should be config.yml instead of config.yaml 😅. Will add a PR with the fix.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants