diff --git a/docs/collections/_development/adding-icons.md b/docs/collections/_development/adding-icons.md
index 8933fa8ee..ccb0e20ab 100644
--- a/docs/collections/_development/adding-icons.md
+++ b/docs/collections/_development/adding-icons.md
@@ -11,7 +11,7 @@ abapGit uses SIL and MIT licensed fonts, they are included in the distribution a
 To add an icon to the icon set follow the next procedure:
 
 1. You need `nodejs` installed (version 10 at the time of this doc creation)
-2. Fork/clone this repo https://github.com/abapGit/icon-font
+2. Fork/clone this repo [abapGit/icon-font](https://github.com/abapGit/icon-font)
 3. Run `npm install` inside
 4. Download [Font Awesome free version](https://fontawesome.com/download)
 5. Copy new SVGs to `svg` folder of the repo
diff --git a/docs/collections/_development/contributing.md b/docs/collections/_development/contributing.md
index 3b9c89103..3a9699fbd 100644
--- a/docs/collections/_development/contributing.md
+++ b/docs/collections/_development/contributing.md
@@ -26,4 +26,4 @@ Alternatively, use the GitHub webinterface to change the files and submit a pull
 
 If you already have an old fork and would like to create a new pull request, 
 you can sync your old fork to current state following this guide: 
-https://github.com/KirstieJane/STEMMRoleModels/wiki/Syncing-your-fork-to-the-original-repository-via-the-browser
+[Sync your fork to original repository](https://github.com/KirstieJane/STEMMRoleModels/wiki/Syncing-your-fork-to-the-original-repository-via-the-browser)
diff --git a/docs/collections/_development/tests.md b/docs/collections/_development/tests.md
index 27bd84f39..aec8277bd 100644
--- a/docs/collections/_development/tests.md
+++ b/docs/collections/_development/tests.md
@@ -3,8 +3,8 @@ title: Unit Tests
 order: 70
 ---
 
-abapGit uses dependency lookup as an approach for writing unit tests, see example in ZCL_ABAPGIT_TADIR, ZCL_ABAPGIT_FACTORY, and ZCL_ABAPGIT_INJECTOR
+abapGit uses dependency lookup as an approach for writing unit tests, see example in ZCL_ABAPGIT_TADIR, ZCL_ABAPGIT_FACTORY, and [ZCL_ABAPGIT_INJECTOR](https://github.com/larshp/abapGit/blob/master/src/zcl_abapgit_injector.clas.testclasses.abap).
 
-Unit tests that create and delete objects in the system are categorized as dangerous, these tests can be enabled via Advanced -> Settings
+Unit tests that create and delete objects in the system are categorized as dangerous, these tests can be enabled via "Advanced > Settings".
 
-Use organization https://github.com/abapGit-tests for storing serialization test cases
+Use organization [abapGit-tests](https://github.com/abapGit-tests) for storing serialization test cases.