diff --git a/README.md b/README.md
index 16483dc01..8ca397762 100644
--- a/README.md
+++ b/README.md
@@ -148,16 +148,19 @@ Determine possible dependency updates
 
 ### Publishing
 
-Publish new releases
+#### Publish new releases to sonatype
 
     ./release.sh
 
+#### Create a release in github
+Click on "Releases" -> "Draft a new release". Create a tag and copy&paste the relevant info from the changelog.<br/>
+Don't publish packages to github. They are published to sonatype.
 
 ## Examples
 
 There are a few examples that may help you to start your first microservice based
 on Edison and Spring Boot. Because Spring Boot itself has some complexity, it is
-recommended to first read it's documentation before starting with Edison.
+recommended to first read its documentation before starting with Edison.
 
 The examples can be started with gradle:
 
diff --git a/build.gradle b/build.gradle
index eaa010901..b7aa5bcb1 100644
--- a/build.gradle
+++ b/build.gradle
@@ -26,6 +26,7 @@ plugins {
 // DO NOT FORGET TO DOCUMENT CHANGES IN CHANGELOG.md
 //
 // Add a GitHub release for every new release: https://github.com/otto-de/edison-microservice/releases
+// Publish artifacts to sonatype by executing the release.sh script. Don't publish packages to github.
 def edison_version = "3.1.5"
 //
 //