updated the documentation and fixed small issues reported by Scrutinizer CI