Better describe why the README is auto-generated.

bamos · bamos · commit 9b92667802c9 · 2015-03-28T15:24:00.000-04:00
diff --git a/generate-readme.py b/generate-readme.py
@@ -5,8 +5,10 @@
 
 """
 Generates the README for
-[bamos/python-scripts](https://github.com/bamos/python-scripts).
-Script descriptions are obtained by parsing the docstrings.
+[bamos/python-scripts](https://github.com/bamos/python-scripts)
+so that the README and scripts contain synchronized documentation.
+Script descriptions are obtained by parsing the docstrings
+and inserted directly into the README as markdown.
 """
 
 import ast
@@ -21,7 +23,8 @@
 
 This is a collection of short Python scripts use in Linux.
 Portions of this README are automatically generated with
-[generate-readme.py](https://github.com/bamos/python-scripts#generate-readmepy).
+[generate-readme.py](https://github.com/bamos/python-scripts#generate-readmepy)
+to insert the script-level comments as descriptions below.
 
 # Adding to your PATH
 I have these added to my `PATH`
