First changes for minor bugs found during review 

Currently reviewing the whole documentation. These are the first changes.