DOC: Change release and whatsnew

.gitignore

@@ -107,6 +107,5 @@ doc/build/html/index.html
 # Windows specific leftover:
 doc/tmp.sv
 doc/source/styled.xlsx
-doc/source/templates/
 env/
 doc/source/savefig/

doc/source/conf.py

@@ -40,6 +40,7 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 # sys.path.append(os.path.abspath('.'))
 sys.path.insert(0, os.path.abspath('../sphinxext'))
+sys.path.insert(0, os.path.abspath('../../scripts'))
 
 sys.path.extend([
 
@@ -53,6 +54,7 @@
 # numpydoc is available in the sphinxext directory, and can't be imported
 # until sphinxext is available in the Python path
 from numpydoc.docscrape import NumpyDocString
+import announce
 
 # -- General configuration -----------------------------------------------
 
@@ -120,7 +122,10 @@
 templates_path = ['../_templates']
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = [
+ '.rst',
+ '.txt',
+]
 
 # The encoding of source files.
 source_encoding = 'utf-8'
@@ -298,8 +303,94 @@
  for page in moved_api_pages
 }
 
+
+common_imports = """\
+.. currentmodule:: pandas
+
+.. ipython:: python
+ :suppress:
+
+ import numpy as np
+ from pandas import *
+ import pandas as pd
+ randn = np.random.randn
+ np.set_printoptions(precision=4, suppress=True)
+ options.display.max_rows = 15
+"""
+
+import re
+import git
+
+xpr = re.compile(r'^v(\d+)\.(\d+)\.(\d+)$')
+repo = git.Repo('..')
+tags = [x.name for x in repo.tags if xpr.match(str(x))]
+versions = sorted(zip(tags,
+ [tuple(map(int, xpr.match(x).groups())) for x in tags]),
+ key=lambda x: x[1])
+
+
+def get_prior(versions, k):
+ if 'k'.endswith('0'):
+ return 
+
+
+contributors = {
+ 'v0.4.0': announce.build_string('v0.3.0..v0.4.0'),
+ 'v0.4.1': announce.build_string('v0.4.0..v0.4.1'),
+ 'v0.4.2': announce.build_string('v0.4.1..v0.4.2'),
+ 'v0.4.3': announce.build_string('v0.4.2..v0.4.3'),
+ 'v0.5.0': announce.build_string('v0.4.0..v0.5.0'),
+ 'v0.6.0': announce.build_string('v0.5.0..v0.6.0'),
+ 'v0.6.1': announce.build_string('v0.6.0..v0.6.1'),
+ 'v0.7.0': announce.build_string('v0.6.0..v0.7.0'),
+ 'v0.7.1': announce.build_string('v0.7.0..v0.7.1'),
+ 'v0.7.2': announce.build_string('v0.7.1..v0.7.2'),
+ 'v0.7.3': announce.build_string('v0.7.2..v0.7.3'),
+ 'v0.8.0': announce.build_string('v0.7.0..v0.8.0'),
+ 'v0.8.1': announce.build_string('v0.8.0..v0.8.1'),
+ 'v0.9.0': announce.build_string('v0.8.1..v0.9.0'),
+ 'v0.9.1': announce.build_string('v0.9.0..v0.9.1'),
+ 'v0.10.0': announce.build_string('v0.9.0..v0.10.0'),
+ 'v0.10.1': announce.build_string('v0.10.0..v0.10.1'),
+ 'v0.11.0': announce.build_string('v0.10.0..v0.11.0'),
+ 'v0.12.0': announce.build_string('v0.11.0..v0.12.0'),
+ 'v0.13.0': announce.build_string('v0.12.0..v0.13.0'),
+ 'v0.13.1': announce.build_string('v0.13.0..v0.13.1'),
+ 'v0.14.0': announce.build_string('v0.13.0..v0.14.0'),
+ 'v0.14.1': announce.build_string('v0.14.0..v0.14.1'),
+ 'v0.15.0': announce.build_string('v0.14.0..v0.15.0'),
+ 'v0.15.1': announce.build_string('v0.15.0..v0.15.1'),
+ 'v0.15.2': announce.build_string('v0.15.1..v0.15.2'),
+ 'v0.16.0': announce.build_string('v0.15.0..v0.16.0'),
+ 'v0.16.1': announce.build_string('v0.10.0..v0.16.1'),
+ 'v0.16.2': announce.build_string('v0.16.1..v0.16.2'),
+ 'v0.17.0': announce.build_string('v0.16.2..v0.17.0'),
+ 'v0.17.1': announce.build_string('v0.17.0..v0.17.1'),
+ 'v0.18.0': announce.build_string('v0.10.0..v0.18.0'),
+ 'v0.18.1': announce.build_string('v0.10.0..v0.18.1'),
+ 'v0.19.0': announce.build_string('v0.10.0..v0.19.0'),
+ 'v0.19.1': announce.build_string('v0.10.0..v0.19.1'),
+ 'v0.19.2': announce.build_string('v0.10.0..v0.19.2'),
+ 'v0.20.0': announce.build_string('v0.10.0..v0.20.0'),
+ 'v0.20.1': announce.build_string('v0.10.0..v0.20.1'),
+ 'v0.20.2': announce.build_string('v0.10.0..v0.20.2'),
+ 'v0.20.3': announce.build_string('v0.10.0..v0.20.3'),
+ 'v0.21.0': announce.build_string('v0.10.0..v0.21.0'),
+ 'v0.21.1': announce.build_string('v0.10.0..v0.21.1'),
+ 'v0.22.0': announce.build_string('v0.10.0..v0.22.0'),
+ 'v0.22.0': announce.build_string('v0.22.0..v0.23.0'),
+ 'v0.23.0': announce.build_string('v0.22.0..v0.23.0'),
+ 'v0.23.1': announce.build_string('v0.23.0..v0.23.1'),
+ 'v0.23.2': announce.build_string('v0.23.1..HEAD'),
+ 'v0.24.0': announce.build_string('v0.23.1..HEAD'),
+
+}
+
+
 html_context = {
- 'redirects': {old: new for old, new in moved_api_pages}
+ 'redirects': {old: new for old, new in moved_api_pages},
+ 'common_imports': common_imports,
+ 'contributors': contributors,
 }
 
 # If false, no module index is generated.
@@ -649,7 +740,23 @@ def process_class_docstrings(app, what, name, obj, options, lines):
 ]
 
 
+def rstjinja(app, docname, source):
+ """
+ Render our pages as a jinja template for fancy templating goodness.
+ """
+ # http://ericholscher.com/blog/2016/jul/25/integrating-jinja-rst-sphinx/
+ # Make sure we're outputting HTML
+ if app.builder.format != 'html':
+ return
+ src = source[0]
+ rendered = app.builder.templates.render_string(
+ src, app.config.html_context
+ )
+ source[0] = rendered
+
+
 def setup(app):
+ app.connect("source-read", rstjinja)
  app.connect("autodoc-process-docstring", remove_flags_docstring)
  app.connect("autodoc-process-docstring", process_class_docstrings)
  app.add_autodocumenter(AccessorDocumenter)

doc/source/index.rst.template

@@ -118,7 +118,7 @@ See the package overview for more detail about what's in the library.
  {{ single_doc }}
  {% endif -%}
  {% if not single_doc -%}
- whatsnew
+ What's New <whatsnew/v0.24.0>
  install
  contributing
  overview
@@ -159,5 +159,5 @@ See the package overview for more detail about what's in the library.
  developer
  internals
  extending
- release
+ releases
  {% endif -%}

doc/source/install.rst

@@ -43,7 +43,7 @@ For more information, see the `Python 3 statement`_ and the `Porting to Python 3
 Python version support
 ----------------------
 
-Officially Python 2.7, 3.5, and 3.6.
+Officially Python 2.7, 3.5, 3.6, and 3.7.
 
 Installing pandas
 -----------------

doc/source/releases.rst

@@ -0,0 +1,193 @@
+.. _release:
+
+*************
+Release Notes
+*************
+
+This is the list of changes to pandas between each release. For full details,
+see the commit logs at http://github.com/pandas-dev/pandas. For install and
+upgrade instructions, see :ref:`install`.
+
+0.23 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.23.2
+ whatsnew/v0.23.1
+ whatsnew/v0.23.0
+
+0.22 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.22.0
+
+0.21 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.21.0.txt
+ whatsnew/v0.21.1.txt
+
+0.20 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.20.0.txt
+ whatsnew/v0.20.2.txt
+ whatsnew/v0.20.3.txt
+
+0.19 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.19.0.txt
+ whatsnew/v0.19.1.txt
+ whatsnew/v0.19.2.txt
+
+0.18 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.18.0.txt
+ whatsnew/v0.18.1.txt
+
+0.17 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.17.0.txt
+ whatsnew/v0.17.1.txt
+
+0.16 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.16.0.txt
+ whatsnew/v0.16.1.txt
+ whatsnew/v0.16.2.txt
+
+0.15 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.15.0.txt
+ whatsnew/v0.15.1.txt
+ whatsnew/v0.15.2.txt
+
+0.14 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.14.0.txt
+ whatsnew/v0.14.1.txt
+
+0.13 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.13.0.txt
+ whatsnew/v0.13.1.txt
+
+0.12 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.12.0.txt
+
+0.11 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.11.0.txt
+
+0.10 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.10.0.txt
+ whatsnew/v0.10.1.txt
+
+0.9 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.9.0.txt
+ whatsnew/v0.9.1.txt
+
+0.8 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.8.0.txt
+ whatsnew/v0.8.1.txt
+
+0.7 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.7.0.txt
+ whatsnew/v0.7.1.txt
+ whatsnew/v0.7.2.txt
+ whatsnew/v0.7.3.txt
+
+0.6 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+
+ whatsnew/v0.6.0.txt
+ whatsnew/v0.6.1.txt
+
+0.5 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+
+ whatsnew/v0.5.0.txt
+
+0.4 release
+------------
+
+.. toctree::
+ :maxdepth: 2
+
+ whatsnew/v0.4.x.txt