For smoothest onboarding process, please read through the instructions in this document before you try do your first commit or pull request.
- You need to have a GitHub account to github.saab.se, which can be requested from ServiceHub
- Once you have an account, reach out to our Mattermost channel and ask for your AD user name to be added as a member to Inner Source organization.
- If you haven't already, we recommend setting up a development environment.
- Before starting to contribute, it is highly recommended to discuss the topic on which you wish contribute through for example Mattermost. It will give us, the maintainers, a head's up and we and others can also provide valuable info to aid you in your contribution.
Start by forking the repository you wish to contribute to, and make your changes locally. Contributes to existing repositories are done through Pull Requests. So when you're done with your changes and have committed them to your fork, it's time to do a pull request back to the original repository. One or more maintainers will have a look at your PR and either reject with comments or approve it before it can be merged to the original repository. For faster approval, it's always wise to have an ongoing discussion about the wanted changes in Mattermost, and ping the maintainers once the PR is ready to be reviewed.
If you want to start up a brand new functionality/add-on or a support library, creating a new repository (based on this template repository, see README.md for instructions) is the best way. You will then be the owner of the repository, and can decide on who can contribute, and how they should do it, but we recommend you stick to the same rules as laid out above.