From 8e11e605a48df37a3fcecede7efc8d2240dd3965 Mon Sep 17 00:00:00 2001
From: "Achim D. Brucker" <adbrucker@0x5f.org>
Date: Sat, 27 Oct 2018 10:41:21 +0100
Subject: [PATCH] Updated documentation.

---
 README.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 62 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 114ad2d5b..39caa8a3c 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,68 @@
-This is a fork of WALA, tracking minor bug-fixes and enhancements required for DASCA.
+# WALA for DASCA
+
+This is a fork of WALA, tracking minor bug-fixes and enhancements required for 
+[DASCA](https://git.logicalhacking.com/DASCA/DASCA).
+
+## Integrating Updates from Upstream
+
+After cloning the repostistory, you need to manually configure the upstream URL
+of the remote fork:
+
+``` sh
+git remote add upstream https://github.com/wala/WALA.git
+```
 
 The default steps for merging with upstream are:
-```
+
+``` sh
   git fetch upstream
   git checkout master
   git merge upstream/master
 ```
+
+## Building Artifacts
+
+This fork uses the gradle setup of the WALA build system. Thus, for details, please
+consult the instructions in the file [README-Gradle](README-Gradle.md). In general, 
+for rebuilding all WALA artifacts, use:
+
+``` sh
+./gradlew clean assemble
+```
+
+## Publishing Artifacts
+
+### Configuration
+
+For publishing artifacts, you need to configure the username and password required
+for uploading to the remote artifacts repository, i.e., you need  to add the following
+properties to your  `GRADLE_USER_HOME/gradle.properties`  (default: `$HOME/.gradle/gradle.properties`)
+file:
+
+``` gradle
+comLogicalhackingArtifactsUser=<USER>
+comLogicalhackingArtifactsPassword=<PASSWORD>
+```
+
+### Preparation
+
+Before publishing new artifacts to the artifacts repository, please update the version identifier in
+the file  `build.gradle` by replacing the second `SNAPSHOT`
+
+``` gradle
+version '1.5.1-SNAPSHOT-DASCA-SNAPSHOT'
+```
+
+with the version that should be published. Next, tag the new version:
+
+``` gradle
+git tag -s "<VERSION>" -m "Tagging version <VERSION>."
+```
+
+### Uploading Artifacts
+
+Publishing artifacts is as easy as calling
+
+``` sh
+./gradlew publish
+```
\ No newline at end of file