Update Readme.md
Change-Id: Idc6968bbd0399aa2f61eb7908b01fcaa9144f240
diff --git a/Readme.md b/Readme.md
index c41b2ff..6fbc37d 100644
--- a/Readme.md
+++ b/Readme.md
@@ -1,16 +1,57 @@
# KorAP Repo Manifest
-This repository contains the files necessary for setting up
-KorAP using [Repo](https://source.android.com/setup/develop/repo), a tool built by the Android development team to manage
-multi-repository projects.
+This repository is primarily aimed at developers who want to build KorAP or one of its components or related tools themselves.
-## Getting started
-To set KorAP using repo, you first might need to [install repo](https://source.android.com/setup/build/downloading#installing-repo).
-Then you can fetch all KorAP repositories:
+It helps to check out all necessary repositories using [Repo](https://source.android.com/setup/develop/repo), a tool built by the Android development team to manage multi-repository projects.
+
+## Getting started
+
+### Create the directories
+
+You’ll need to set up some directories in your build environment.
+
+To create them:
```bash
-mkdir KorAP
-cd KorAP
+mkdir -p ~/bin
+mkdir -p ~/KorAP
+```
+
+The ~/bin directory will contain the git-repo tool (commonly named “repo”) and the ~/KorAP directory will contain the source code of KorAP.
+
+### Install the `repo` command
+
+Enter the following to download the repo binary and make it executable (runnable):
+
+```bash
+curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
+chmod a+x ~/bin/repo
+```
+
+### Put the `~/bin` directory in your path of execution
+
+In recent versions of Ubuntu, `~/bin` should already be in your PATH. You can check this by opening `~/.profile` with a text editor and verifying the following code exists (add it if it is missing):
+
+```bash
+# set PATH so it includes user's private bin if it exists
+if [ -d "$HOME/bin" ] ; then
+ PATH="$HOME/bin:$PATH"
+fi
+```
+
+### Configure git
+
+Given that repo requires you to identify yourself to sync KorAP sources, run the following commands to configure your git identity:
+
+```bash
+git config --global user.email "you@example.com"
+git config --global user.name "Your Name"
+```
+
+### Initialize the KorAP source repositories
+
+```bash
+cd ~/KorAP
repo init -u https://korap.ids-mannheim.de/gerrit/KorAP/manifest
repo sync
```