update doc

README.md

@@ -20,6 +20,27 @@ It is not a transpiler from Java to Javascript like  [datathings/java2typescript
 
 * [jvm-npm](https://github.com/bsorrentino/jvm-npm)
 
+## Description
+
+Basic idea is to develop a Project by mixing Java & Javascript code or even all in Javascript relying on the  [Nashorn Javascript engine](http://www.oracle.com/technetwork/articles/java/jf14-nashorn-2126515.html) embedded in JDK from Java8. This powerful engine enable Javascript language in JVM and allows to access to every java class either from JDK and external JAR(s) in a pretty straightforward way.
+That's cool, the Javascript is very easy to learn, but the question are :
+ 1. _Is it possible develop a complete and well structured Javascript application ?_
+ 1. _Developing in Javascript on JVM is as productive as programming in Java ?_
+
+Just to answer the questions above that this project has been developed.
+
+> 1. _Is it possible develop a complete and well structured Javascript application ?_
+>> **Yes it is, but with help of a powerful [Typescript](https://www.typescriptlang.org/) that fills language's gaps and produce Javascript as output**  
+>
+> 1. _Developing in Javascript on JVM is as productive as programming in Java ?_
+>> **Yes it could be, but we need :**
+>> * An IDE with intellisense capability that is able to inspect java/javascript classes during development.
+>>> **This is the main goal of project, that is to generate Typescript Declarations enabling every Typescript-Aware IDE (eg. [Atom](https://ide.atom.io/), [VSCode](https://code.visualstudio.com/)) to give you the __intellisense__ feature make more comfortable use access to Java features/classes from Javascript**
+>>
+>> * A module module system that allow to arrange application in separate well-defined modules
+>>> **This is achieved by project [jvm-npm](https://github.com/bsorrentino/jvm-npm) that enable use of [commonJS](https://en.wikipedia.org/wiki/CommonJS) enabling [Typescript Modules](https://www.typescriptlang.org/docs/handbook/modules.html).**
+>
+
 ## Getting Started
 
 ### Use Maven Archetype