From: Dan Untenzu <untenzu@webit.de>
Date: Thu, 23 Feb 2017 15:19:03 +0000 (+0100)
Subject: [FEATURE] Add walktrough to create merge requests
X-Git-Tag: 3.0.0~3
X-Git-Url: https://git.p6c8.net/jirafeau_mojo42.git/commitdiff_plain/3fe355234450caeae334086149b06a504af86825?hp=f2ec213d8b9b828c8f81b82349cc103328a5a2e5

[FEATURE] Add walktrough to create merge requests

Explain a bit how merge requests are made on Gitlab
to easen the hurdle for new contributors.

Refs #104
---

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 7c5ed44..f7f21ed 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -4,6 +4,8 @@ Hi,
 
 this document is made for newcomers in Jirafeau who are digging into the code.
 
+If you have further questions, then just ask for help 🤓.
+
 ## General principle
 
 Jirafeau is made in the [KISS](http://en.wikipedia.org/wiki/KISS_principle) way (Keep It Simple, Stupid).
@@ -71,3 +73,14 @@ Please create one branch for each feature and send one merge request for each br
 Dont squash several changes or commits into one merge request as this is hard to review.
 
 Please use ```next-release``` as base branch and send your merge request to this branch (not ```master```).
+
+Quick walktrough:
+
+* Create ticket for new feature
+* Fork the original repository, clone the own repository, add the original repository as upstream
+* Checkout »next-release« branch ```git checkout next-release```
+* Create a new branch on top of that one, e.g. »some-feature« ```git checkout -b some-feature```
+* Commit changes → push → send merge request ```git add -A; git commit; git push``` MR via GitLab (link shown in console)
+* Feature is reviewed
+  * MR accepted: Reviewer checks out »next-release« branch and cherry-picks the commit ```git checkout next-release; git cherry-pick be4369641; git push```
+  * MR declined: Reviewer add some notes, Developer rebases his branch, adds neccessary changes, force pushes the branch, ask a reviewer to review the changes in the merge request ticket (as Gitlab recognizes them automatically) ```git checkout some-feature; git rebase upstream/next-release``` …[add changes]… ```git add -A, git commit --amend; git push -f```