check-docstrings.sh script and some comments for create-apidoc.sh

 - check-docstrings invokes pep257 on the xylem package
   and silences some know warnings as well as missing
   docstring warnings.
 - Check the scripts files for a description. They mainly exist to
   remember the commands and save some typing.
Fix indentation.