Documentation update

Thanks to Alex Susu for some suggestions.
There are still many things left to update.