diff --git a/README.md b/README.md index a5bb4cd..f636b40 100644 --- a/README.md +++ b/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