Dev/improve documentation

Added/modified some documentation which helped me get oriented when working with the code.
Modified some doxygen control words that did not work well for me.