tutorial.md fixes and tweaks
minor tweaks to reader.py and writer.py