DOC: change not to backup github stats + add glob toc

tacaswell · tacaswell · commit 3add36633b1a · 2019-02-24T13:21:39.000-05:00
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
@@ -50,7 +50,11 @@ is currently broken::
 GitHub Stats
 ------------
 
-We automatically extract GitHub issue, PRs, and authors from GitHub via the API::
+
+We automatically extract GitHub issue, PRs, and authors from GitHub via the API.
+copy the current :file:`github_stats.rst` to :file:`github_stats_X.Y.Z.rst`.
+
+To re-generate the updated ::
 
   python tools/github_stats.py --since-tag v2.2.0 --milestone=v3.0 --project 'matplotlib/matplotlib' --links > doc/users/github_stats.rst
 
diff --git a/tools/github_stats.py b/tools/github_stats.py
@@ -227,3 +227,16 @@ def report(issues, show_urls=False):
         print()
         print('Issues (%d):\n' % n_issues)
         report(issues, show_urls)
+    print()
+    print()
+    print("""Previous GitHub Stats
+---------------------
+
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    github_stats_*
+
+""")
