From 3ee994d9bf0ffd17e159f4bafe68b9735d7b6ea2 Mon Sep 17 00:00:00 2001 From: Tiago Ilieve Date: Tue, 8 Apr 2014 08:30:43 -0300 Subject: [PATCH] Add contribution guidelines I've added a _Contributing_ section to the README and a [CONTRIBUTING file](https://github.com/blog/1184-contributing-guidelines). I do not expected for these changes to be merged right away, as they can be seen as a draft from what I've observed in the past weeks. The intention here is not only help the developers that are new to the project, but also make it easier for Anders to deal with new patches. --- CONTRIBUTING.md | 29 +++++++++++++++++++++++++++++ README.md | 7 +++++++ 2 files changed, 36 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..07f3a5e --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,29 @@ +Contributing +============ + +Do you want to contribute to the bootstrap-vz project? Nice! Here is the basic workflow: + +* Fork this repository. +* Make any changes you want/need. +* Commit your changes. +* Squash the commits if needed. For instance, it is fine if you have multiple commits describing atomic units +of work, but theres no reason to have many commits just because of corrected typos. +* Push to your fork, preferable on a topic branch. + +By this moment, there are two paths that you have to consider: + +If you patch is a new feature, e.g.: plugin, provider, etc. then: + +* Send a pull request to the `development` branch. It will be merged to the `master` branch when we can make +sure that the code is stable. + +If it as a bug/security fix: + +* Send a pull request to the `master` branch. + +Please try to be very descriptive about your changes when you write a pull request, stating what it does, why +it is needed, what use cases do you think it would be useful, etc. + +Be aware that your modifications needs to be properly documented and pushed to the `gh-pages` branch. + +Happy hacking! :-) diff --git a/README.md b/README.md index f6a2a9a..b9c756a 100644 --- a/README.md +++ b/README.md @@ -22,3 +22,10 @@ and learn [how you create a manifest](http://andsens.github.io/bootstrap-vz/mani Developers ---------- The API documentation can be found at [bootstrap-vz.readthedocs.org](http://bootstrap-vz.readthedocs.org). + +Contributing +------------ + +Contribution guidelines are described on the [CONTRIBUTING](CONTRIBUTING.md) file. +There's also a [topic on the documentation](http://andsens.github.io/bootstrap-vz/development.html#coding_style) +regarding the coding style.