review documentation

proof read of the documentation to fix minor typos etc.
not all files were reviewed at this time.
for issue #2048
I think there's only interoperability problems with new lambda based bytecode (trying to call a lambda based method from Scala).