diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..fd2ebb9 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,46 @@ +Contributing +============ + +👍🎉 Thanks a lot for considering contributing 🎉👍 + +We welcome and encourage contribution. There is many way to contribute: you can +write bug report, contribute code or documentation (take a look at the +[Wiki section](https://github.com/gsilano/EuropeCV/wiki)). + +## Reporting issues + +When reporting issues the more information you can supply the better. + +If it is an issue with building the LaTeX package, indicate your environment like operating system and, +version of MikTeX your are using. + +## Improvements request and proposal + +Feel free to make an issue to request a new functionality. + +## Contributing code/Pull-Request + +We welcome contribution, this can be done by starting a pull-request. +You can contribute by updating the package content or styling, code (.cls file), or both. + +### Contributing content or styling + +There is a couple of basic requirement for us to merge the pull request: + - The styling should maintain the compatibility with previous versions. For example, if you plan to + add a new number to the contact information, it should be optional and not mandatory allowing not to + change anything to the other users of the package. + +### Contributing code + +If the change is big, typically if the change span to more than one file, consider starting an issue first to discuss the improvement. +This will makes it much easier to make the change fit well into the package. + +There is some basic requirement for us to merge a pull request: + - Describe the change (a bot will remind you in case you forget it) + - Refer to any issues it effects + - Separate one pull request per functionality: if you start writing "and" in the feature description consider if it could be + separated in two pull requests. + +In your code: + - Make sure the coding style of your code follows the style of the file. + diff --git a/README.md b/README.md index b71a602..fd64b40 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,8 @@ Well, if you are reading this section it means that you are thinking of helping 2. Each change must be reported in the ```CHANGELOG``` file. Please, do not forget to be clear and specify who made this contribution. -3. In the head of each file, is the date on which the last changes were made. Please, do not forget to update this information. The same procedure must be followed in the tex file ```europecv.tex```. +3. In the head of each file, there is the date on which the last changes were made. Please, do not forget to update this information. The same procedure must be followed in the tex file ```europecv.tex``` (at the beginning of the file a date says when the file has been changed). + +In any case, please take a look to the [Contributing.md](https://github.com/gsilano/EuropeCV/blob/master/CONTRIBUTING.md) file.