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

Github codeowners/templates changes #1491

Merged
merged 5 commits into from
Sep 28, 2023
Merged

Github codeowners/templates changes #1491

merged 5 commits into from
Sep 28, 2023

Conversation

lemunozm
Copy link
Contributor

Changes and Descriptions

  • Removed *.toml matching to avoid having all of us in all PRs.
  • (opinionated) Removed more template sections. I think most of all, do not use those sections, and in a lot of cases, it does not apply to the issue/PR purpose, and it only puts another mind barrier to open new issues. I think open issues should be something fast/easy/kind to incentivize tracking our task.

@lemunozm lemunozm added the crcl-protocol Circle protocol related. label Aug 11, 2023
@lemunozm lemunozm self-assigned this Aug 11, 2023
NunoAlexandre
NunoAlexandre previously approved these changes Aug 11, 2023
Copy link
Contributor

@NunoAlexandre NunoAlexandre left a comment

Choose a reason for hiding this comment

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

Agreed and approved 🤝

Copy link
Contributor

@wischli wischli left a 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.

Comment on lines 11 to 16
# 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
Copy link
Contributor

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.

Copy link
Contributor

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.

Copy link
Contributor Author

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.

Comment on lines 3 to 15
[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?]
Copy link
Collaborator

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.

Copy link
Contributor

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 👍

Copy link
Contributor

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.

Copy link
Collaborator

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

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 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

Copy link
Contributor

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.

Copy link
Contributor

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?

@lemunozm
Copy link
Contributor Author

I knew it would open discussions 😆

mustermeiszer
mustermeiszer previously approved these changes Aug 11, 2023
@lemunozm
Copy link
Contributor Author

I'll leave this PR open until/during next week, to get a chance for others to give arguments

@lemunozm
Copy link
Contributor Author

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?

@lemunozm
Copy link
Contributor Author

@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

@lemunozm lemunozm enabled auto-merge (squash) September 28, 2023 06:29
@lemunozm lemunozm merged commit 0387385 into main Sep 28, 2023
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
crcl-protocol Circle protocol related.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants