Better documentation

These changes have been automatically suggested by scrutinizer-ci.com