diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000000000000000000000000000000000..fe0c3acb05f56353cf2544bc41e519591a7c58df --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,52 @@ +# Contributing + +When contributing to this repository, please first discuss the change you wish to make via issue and +via the [forum](https://forum.duniter.org) before making a change. + +Please note we have a specific workflow, please follow it in all your interactions with the project. + +## Workflow + +- You must create an issue for each feature you wish to develop, with a precise title and a + description of your feature. Then, assign it to yourself and click on the button + **`Create a merge request`**. GitLab will create a branch dedicated to the issue as well as a + *Work in Progress* merge request of this branch into the main branch (`dev`). +- Please use tags to specify feature domains and concerned crates. +- Never contribute to a branch whose issue has not been assigned to you! If the contributor make a + `git rebase` your commit will be lost ! +- Before you push your commit: + 1. Document your code. + 1. Write unit tests, and verify that they **all** pass. + 1. Made a git rebase to make your history clean. + + ```bash + # Make an alias + git config --global alias.tidy "rebase -i @{upstream}" + # Rebase your last commits since last push + git tidy + ``` + +## Merge Process + +1. Ensure any install or build dependencies are removed before the end of the layer when doing a + build. + +1. Ensure you rebased your branch on the latest `dev` commit to avoid any merge conflicts. + +1. Update the README.md with details of changes to the interface, this includes new environment + variables, exposed ports, useful file locations and container parameters. + +1. Increase the version numbers in any examples files and the README.md to the new version that this + Pull Request would represent. The versioning scheme we use is [SemVer](http://semver.org/) : + + If the module is in developement stage, its format is 0.X.Y. In production stage, it's X.Y.Z. + + - When a API breaking change is made, X must be incremented. + - If new features are added without breaking the API, Y must be incremented. + - If the change is a quick fix of a production version, Z is incremented. + + Your module should always start with 0.1.0 version and only pass in 1.0.0 when no big changes are + planned. There is no need to rush a 1.0.0, take your time :) + +1. You may merge the Merge Request in once you have the sign-off of two other developers. If you + do not have permission to do that, you may request the second reviewer to merge it for you. \ No newline at end of file