review documentation

proof read of the documentation to fix minor typos etc.
not all files were reviewed at this time.
for issue #2048
Are you sure about this? Can't Gating run with JDK8? I thought the limitations were about interoperatibility with Java 8 specific bytecode.