Skip to content

Latest commit

 

History

History
70 lines (44 loc) · 4.29 KB

CONTRIBUTING.md

File metadata and controls

70 lines (44 loc) · 4.29 KB

Contributing

Thanks for your interest in contributing to rsvp-place! 💖

After this page, see DEVELOPMENT.md for local development instructions.

Code of Conduct

This project contains a Contributor Covenant code of conduct all contributors are expected to follow.

Reporting Issues

Please do report an issue on the issue tracker if there's any bugfix, documentation improvement, or general enhancement you'd like to see in the repository! Please fully fill out all required fields in the most appropriate issue form.

Sending Contributions

Sending your own changes as contribution is always appreciated! There are two steps involved:

  1. Finding an Issue
  2. Sending a Pull Request

Finding an Issue

With the exception of very small typos, all changes to this repository generally need to correspond to an open issue marked as status: accepting prs on the issue tracker. If this is your first time contributing, consider searching for unassigned issues that also have the good first issue label. If the issue you'd like to fix isn't found on the issue, see Reporting Issues for filing your own (please do!).

Sending a Pull Request

Once you've identified an open issue accepting PRs that doesn't yet have a PR sent, you're free to send a pull request. Be sure to fill out the pull request template's requested information -- otherwise your PR will likely be closed.

PRs are also expected to have a title that adheres to commitlint. Only PR titles need to be in that format, not individual commits. Don't worry if you get this wrong: you can always change the PR title after sending it. Check previously merged PRs for reference.

Draft PRs

If you don't think your PR is ready for review, set it as a draft. Draft PRs won't be reviewed.

Granular PRs

Please keep pull requests single-purpose: in other words, don't attempt to solve multiple unrelated problems in one pull request. Send one PR per area of concern. Multi-purpose pull requests are harder and slower to review, block all changes from being merged until the whole pull request is reviewed, and are difficult to name well with semantic PR titles.

Pull Request Reviews

When a PR is not in draft, it's considered ready for review. Please don't manually @ tag anybody to request review. A maintainer will look at it when they're next able to.

PRs should have passing GitHub status checks before review is requested (unless there are explicit questions asked in the PR about any failures).

Requested Changes

After a maintainer reviews your PR, they may request changes on it. Once you've made those changes, re-request review on GitHub.

Please try not to force-push commits to PRs that have already been reviewed. Doing so makes it harder to review the changes. We squash merge all commits so there's no need to try to preserve Git history within a PR branch.

Post-Merge Recognition

Once your PR is merged, if you haven't yet been added to the Contributors table in the README.md for its type of contribution, you should be soon. Please do ping the maintainer who merged your PR if that doesn't happen within 24 hours - it was likely an oversight on our end!