note that versions newer than 1.1.1 are ok as well

Proof-read to remove some typos and add some details.

fix gitignore and add missing java markdown

final tweaks for 1.1.x version