updated the documentation and fixed small issues reported by Scrutinizer...

... CI