revise README files, explain recent additions
tweak docstring header in test_writers