review documentation

proof read of the documentation to fix minor typos etc.
not all files were reviewed at this time.
for issue #2048
Quite possible.
Still, no problem with running Gatling, which produces Java7 bytecode, on a JDK8, as you'd expect.