-
Notifications
You must be signed in to change notification settings - Fork 87
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
Github codeowners/templates changes #1491
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Agreed and approved 🤝
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Apart from the PR checklist removal, I fully agree with the changes. I also think the issue template is overhead it most occasions such that many chose to ignore it.
.github/pull_request_template.md
Outdated
# Checklist: | ||
|
||
- [ ] I have added Rust doc comments to structs, enums, traits and functions | ||
- [ ] I have made corresponding changes to the documentation | ||
- [ ] I have performed a self-review of my code | ||
- [ ] I have added tests that prove my fix is effective or that my feature works |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I am not sure whether I can agree with this removal. Personally, I go through this checklist for every PR but I suppose the reality is, that it is rather ignored and many PRs do not include any ticks.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same here, I like having this checklist for chores that might be forgotten.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, In some PRs, I also found myself reading it to check mentally if things were done.
But, I found 2 points against having this there (maybe some other in place?).
- Most of the time, some points do not apply to the PR meaning.
- Most of the time, PRs are merged without clicking done in all those points.
From my point of view, I think each PR has its own checklist and should be thought of specifically for the PR purpose. So I agree with adding a checklist, but I think should be done explicitly at that moment of creation for the content of that PR.
.github/issue_template.md
Outdated
[Description of the issue or feature] | ||
|
||
### Research/based on | ||
|
||
[Which codebases, pallets or designs did you base your design on] | ||
|
||
### How will this affect the code base | ||
|
||
[Does it improve readability, performance? Will it introduce new complexity?] | ||
|
||
### What are foreseen obstacles or hurdles to overcome? | ||
|
||
[Are migrations needed, structural changes around testing etc?] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like that sections TBH and found it helpful to have the structure.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
my POV is that these are often good questions to ask oneself when creating an issue but I personally don't find value is having to try and fit this structure per se. my 2cents, whatever is more helpful to the team is good with me 👍
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMO a section for description and probably another one for extra notes might be more than enough.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I am good with what the matority wants
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I do not have a strong opinion of these sections. It's true that sometimes they do not apply to the issue or can be handled by tags (as "migration needed"), but they also help to explain the issue better
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Personally, I would like to keep this but it seems like the majority choses to ignore it. I don't have a strong opinion.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@wischli maybe we can find a middle ground that makes everyone happy?
I knew it would open discussions 😆 |
I'll leave this PR open until/during next week, to get a chance for others to give arguments |
I think, given most of you want to keep these template parts, I'm going to leave it as it is. If in some months you find it less usable, then can remove it. Is everyone ok with it? |
@wischli @NunoAlexandre @cdamian @mustermeiszer would you want to add yourself to the CODEOWNERS file with the new liquidity-pools-related content we added last month? Feel free to add a commit in this branch |
c96cd00
9c9f904
to
c96cd00
Compare
c96cd00
to
88a1d33
Compare
Changes and Descriptions
*.toml
matching to avoid having all of us in all PRs.