Update Readme, avoid java8 javadoc warnings

README.md

@@ -1,8 +1,12 @@
-# Java RAML 1.0 Parser <sup>(beta)</sup>
+# RAML Java Parser
+[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/raml-org/raml-java-parser?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-See http://raml.org for more information about RAML.
+This is a Java implementation of a [RAML](http://raml.org) parser for versions [1.0](http://raml.org/raml-10-spec) and [0.8](http://raml.org/raml-08-spec).
+The parser depends on SnakeYaml, a Java YAML parser.
+
+The old version that only support RAML 0.8 is still available [here](https://github.com/raml-org/raml-java-parser/tree/v1).
 
-This parser is in beta state of development.
+See http://raml.org for more information about RAML.
 
 
 ## Build
@@ -34,8 +38,6 @@ if (ramlModelResult.hasErrors())
 else
 {
     Api api = ramlModelResult.getApiV10();
-    
+
 }
 ```
-
-

pom.xml

@@ -4,6 +4,8 @@
     <artifactId>raml-parser-parent</artifactId>
     <version>1.0.0</version>
     <packaging>pom</packaging>
+    <name>Raml Java Parser 2nd generation parent</name>
+    <description>Raml parser implemented in java</description>
 
     <modules>
         <module>yagi</module>
@@ -191,6 +193,9 @@
                         <groupId>org.apache.maven.plugins</groupId>
                         <artifactId>maven-javadoc-plugin</artifactId>
                         <version>2.10.3</version>
+                        <configuration>
+                            <additionalparam>-Xdoclint:none</additionalparam>
+                        </configuration>
                         <executions>
                             <execution>
                                 <id>attach-javadocs</id>