revised tutorial.md [ci skip]
comment tweaks for reader.py and writer.py module