Skip to main content

Getting Started

Hello Newcomer, here are some tips to help you get started contributing to this project.

Get to know the project#

Here's what you can do to know more about the project:

Choose a working item#

  1. Check the available issues (that anyone can contribute to) or first timers only issues (just for first time contributors in this project);
  2. Choose one issue you want to work on;
  3. Ask maintainers, on the issue's comment section, if you can work on it;
  4. Once you get approval you can start working on it.

Start working#

Before you start working check the Contribution Guidelines to make sure you can follow the best practises.

In short:

  1. Fork the project into your profile;
  2. Clone the project into your workspace on your computer;
  3. Setup remotes to keep your develop branch with systers repository;
  4. Create a specific branch based from develop branch for your specific feature;
  5. Start coding;
  6. Make sure you follow this Commit Message Style Guide;
  7. Once you finish working on your issue, submit a Pull Request (PR) (following the template provided);
  8. If the reviewers request changes on your PR, make the changes (this can be a back and forth process where you make changes according to reviewers feedback);
  9. Make sure when you finish your changes you squash your commits into a single commit;
  10. Once the reviewers approve your PR, they can merge and your code will finally be part of the main repository.