Merge pull request eclipse-archived#567 from bosch-io/neubs-bsi/doc/m…

…vnVersion

Add note to Maven version for stable Antenna build.

README.md

@@ -27,7 +27,7 @@ Some of these folders contain their own `README.md`, like e.g. `./modules/sw360/
 
 ### Install and build Antenna
 
-Please note that some dependencies of SW360antenna are only available for Java 8. So you need to use Java 8 to build the project.
+Please note that some dependencies of SW360antenna are only available for Java 8. So you need to use Java 8 to build the project. 
 
 If you want to build Antenna on the command line, just use Maven like
 
@@ -37,6 +37,19 @@ By default, this will run tests. If you want to skip running tests use
 
     $ mvn install -DskipTests
 
+The build is stable starting with Maven version `3.5.x` or higher, which was 
+when the [usage of the `revision` property](https://maven.apache.org/maven-ci-friendly.html) was introduced. 
+With a lower version you will get errors when trying to resolve dependencies created in the Antenna build,
+since the version is not correctly parsed. A possible error message would look like this:
+
+```  
+Failed to process POM for org.eclipse.sw360.antenna:model:jar:1.0.0-SNAPSHOT: 
+Non-resolvable parent POM for org.eclipse.sw360.antenna:model:1.0.0-SNAPSHOT: 
+Could not find artifact org.eclipse.sw360.antenna:antenna-management:pom:${revision} 
+in central (https://repo.maven.apache.org/maven2/) and 'parent.relativePath' points at wrong local POM
+[ERROR] org.eclipse.sw360.antenna:model:jar:1.0.0-SNAPSHOT
+```
+
 #### Optional Profiles
 You can activate the following optional profiles:
 - `-P integration-test`: activates also the optional profile for integration testing in the sw360 module (see also `./modules/sw360/README.md`)