diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ba1e46b89..2f163c5aa 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -15,10 +15,10 @@ You have a new feature, bug fix, or other modification you want to contribute to
This will require a few steps to setup your own github fork and be able to create a PR to the official devel version of the SPECFEM code (**note that only Pull requests towards devel are accepted**). The most basic setup looks the following:
-1. Create your fork of the repository:
+#### 1. Create your fork of the repository:
Go to the main [SPECFEM2D github repository](https://github.com/SPECFEM/specfem2d) and click the "*Fork*" button at the top of the page. This will create a copy of the SPECFEM2D repository in your personal GitHub account.
-2. Clone your fork to your local workstation/laptop:
+#### 2. Clone your fork to your local workstation/laptop:
```
git clone --recursive --branch devel https://github.com/SPECFEM/specfem2d.git
```
@@ -38,19 +38,19 @@ Please make sure that your local version is up-to-date with the upstream version
```
git pull upstream devel
```
-or
+or
```
git fetch upstream
git rebase --interactive upstream/devel
```
-
-3. Apply your modifications to your local code and commit your changes:
+
+#### 3. Apply your modifications to your local code and commit your changes:
Check first the status of the files, and/or differences applied before committing, by typing
-```
+```
git status
```
and
-```
+```
git diff
```
Then, create the commit with a short descriptive message by
@@ -59,20 +59,25 @@ git commit -m ""
```
Remember that it is good practice to have small commits with a single purpose.
-4. Push your modifications to your github repository:
+#### 4. Push your modifications to your github repository:
```
git push
```
+or more explicit
+```
+git push origin devel
+```
-5. Now, open a new "*Pull request*" on the github website:
+#### 5. Open a new "*Pull request*" on the github website:
Go to your personal github repository website, and possibly click on the branch button to change to the **devel** branch.
Github might already recognize that you have new changes uploaded, sees that your branch is "*ahead of SPECFEM:devel*" and provides you with the option to "*Contribute*" by clicking on the "*Open pull request*" button.
In the "*Open a pull request*" page, double-check that the base repository is: **SPECFEM/specfem2d, base: devel**. The head repository should be your personal fork with "*compare: devel*". Write an appropriate title and add more descriptions to your pull request in the "*Leave a comment*" section. Finally, click the "*Create pull request*" button.
-6. We'll do the rest by reviewing your code changes, checking if the Github Actions, Travis and Azure checks all look okay. We might follow up with you by commenting on the PR, as you can still fix smaller issues in the PR by committing them to your github fork version.
-
+#### 6. Final merge:
+We'll do the rest by reviewing your code changes, checking if the Github Actions, Travis and Azure checks all look okay. We might follow up with you by commenting on the PR, as you can still fix smaller issues in the PR by committing them to your github fork version.
+
Finally, if the are no merge conflicts, the new version still compiles and tests pass, we'll merge your PR into the SPECFEM devel version - **with big thanks to you from the maintainers and the whole community!**
-
+
## Further informations