improve documentation

fixes #1391

and add improvements/fixes to documentation
I think is better to use "low", "intermediate" and "high" levels... "very high" could be confusing when you talk quickly about that...