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

Add contributing guide #422

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Conversation

pierre-eliep-met
Copy link
Collaborator

@pierre-eliep-met pierre-eliep-met commented May 11, 2023

Goal

Adds a contributing guide to MML

Type of change

  • Bugfix
  • New feature
  • Refactoring change
  • Release & Version Update (don't forget to change the version number in package.mo)
  • Documentation

Will it break anything in previous models ?

  • Breaking change (If yes, make sure to point it out in the changelog)
  • Non-Breaking change

Checklist

  • I have added the appropriate tags, reviewers, projects (and detailed the size and priority of my PR) and linked issues to this PR
  • I have performed a self-review of my own code
  • I have checked that all existing tests pass.
  • I have added/updated tests that prove my development works and does not break anything.
  • I have made corresponding changes or additions to the documentation (in Notion documentation)
  • I have added corresponding entries to the Changelog
  • I have checked for conflicts with target branch, and merged/rebased in consequence

You can also fill these out after creating the PR, but make sure to check them all before submitting your PR for review.

@pierre-eliep-met pierre-eliep-met self-assigned this May 11, 2023
@pierre-eliep-met pierre-eliep-met added the 📝documentation Improvements or additions to documentation label May 11, 2023
@pierre-eliep-met pierre-eliep-met marked this pull request as ready for review May 11, 2023 16:10
@pierre-eliep-met pierre-eliep-met added the 🗃️skip-changelog Changes that should be omitted from the release notes label May 11, 2023
CONTRIBUTING_GUIDE.md Outdated Show resolved Hide resolved
- **Do not attach sensitive data to the GitHub issue you create**
- Pick the appropriate template (bug report or feature request) and fill it with your issue details

## You know how to fix a bug / add a new feature ?
Copy link
Collaborator

Choose a reason for hiding this comment

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

Is this part internal or external use?
If someone outside of the team wants to suggest a PR, we would be doing the reviewing and the merging. I think we need to take the time to think of what external contributors will and will not be able to do with the repo. Do you know what are the good practices for open source repos?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I think the most standard permission for external users is Triage (see the detailed permissions here), basically you can create issues, but not apply any modifications to the code yourself (can't push, can't merge, etc.)
Notably, with Triage permissions you need to fork the repo so that you have a copy of the existing repo with write access, do the dev on your local repo, then create a PR to original repo

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

If you want a user to be able to create a branch and PR on the MML repo, you have to give write access, meaning a lot of things, almost as much as any process team member

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

But if we have the high enough paid plan, we can create our own role

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📝documentation Improvements or additions to documentation 🗃️skip-changelog Changes that should be omitted from the release notes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOC] Create contributing guide to explain how to tag releases and how to merge changes
2 participants