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

[DISCUSSION] Standardize the contributions #62

Closed
ashiishme opened this issue Apr 24, 2024 · 8 comments
Closed

[DISCUSSION] Standardize the contributions #62

ashiishme opened this issue Apr 24, 2024 · 8 comments

Comments

@ashiishme
Copy link

ashiishme commented Apr 24, 2024

There are many PRs created without discussion and also some of them are merged that can conflict with other PRs. It's a really good thing to have many contributors but I believe we should standardize the process otherwise it will be harder to maintain.

I have opened this issues to discuss about some of the standard ways we can implement together with the maintainers of this project apart from the contribution guidelines. There are indeed many ways we can improve but I believe these are some of the important steps we should take now:

  1. Issue creation should be mandatory
  2. PR template
  3. Define codeowners
  4. Branch protections

Issue creation should be mandatory

Any PRs created without a discussion shouldn't be accepted, there should be a proper discussion on why we need the changes. This is a good way to filter unwanted PRs as well as reduce the duplicate PRs. The discussion can be held by creating an issue and to conclude the next step.

PR template

We can introduce a basic PR template that will prompt the contributors to answer some questions or read some information before they create the PR.

This will be very helpful to ask them to follow some guidelines without any manual effort. One good example is to "ask them if there are any issue created?" If not, they should create first.

We can discuss more on what guidelines to set in PR template by creating an issue for this topic.

Define codeowners

It will be really good if there is a codeowners file setup for this project. There are several advantages:

  • Everyone is aware of the core contributors so that they can be tagged in multiple discussions for clarify.
  • Every PRs opened will be assigned to them as the reviewers.
  • They get the notification to review the new PRs.

Branch protections

We can protect the main branch with different cases but what I feel currently we need is to make it mandatory that each PRs before merge should be approved by at least one core maintainers (currently anyone can approve). Although the merge is only done by the core maintainers it should be mandatory.

Please feel free to add your thoughts about the above ideas.

@yubinkarki
Copy link
Contributor

Great idea. I was wondering about the PR template as well. I had created such a template in my personal project a while back. Here's the project (.github directory) if anyone is eager to add the document.

@thesushilsharma
Copy link

Please use the new issue template workflow. About issue and pull request templates..

This is an official GitHub resource that provides a comprehensive guide on PR templates, including purpose and benefits, configuring and creating templates, syntax options, and how to use issue templates alongside PR templates. By following this guide, we can create effective PR templates that promote high-quality contributions to our project.

Let me know if you need any help.

@urs-santoshh
Copy link
Contributor

I've created a pull request #74 to implement the templates as discussed. Please take a moment to review the pull request and share any additional thoughts or suggestions you may have.

@thesushilsharma
Copy link

Owners can set up templates from the repo settings for issues and discussions.

image
image

Modern Template
I have created an issue template using modern issue forms. (beta version)
Review it.

@urs-santoshh
Copy link
Contributor

@thesushilsharma I have closed this pull request #74. I'll make the changes accordingly and create a new pull request.

@urs-santoshh
Copy link
Contributor

@thesushilsharma I have used your template and tried to customize it a bit to better fit the project's needs. Please take a moment to review it.

@ashiishme
Copy link
Author

@urs-santoshh It would be better if you can create issue first before PR. For the current PR, you can create issue and link them. We should always discuss about the new changes/introduction and come with a common agreement before creating PR.

@sumanashrestha
Copy link
Collaborator

I think we have a good enough template. closing this issue

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

No branches or pull requests

5 participants