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,39 @@
     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
+"""
+
+
+def get_contributors(start, end):
+
+    return announce.build_string('{}..{}'.format(start, end), None)
+
+
+contributors = {
+    'v0.24.0': announce.build_string('v0.23.1..HEAD'),
+    'v0.23.2': announce.build_string('v0.23.1..HEAD'),
+    'v0.23.1': announce.build_string('v0.23.0..v0.23.1'),
+    'v0.23.0': announce.build_string('v0.22.0..v0.23.0'),
+}
+
+
 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 +685,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/release_index.rst

@@ -0,0 +1,34 @@
+.. _release:
+
+.. currentmodule:: pandas
+
+.. ipython:: python
+   :suppress:
+
+   import pandas as pd
+   import numpy as np
+   np.random.seed(123456)
+   np.set_printoptions(precision=4, suppress=True)
+   import matplotlib.pyplot as plt
+   plt.close('all')
+
+   pd.options.display.max_rows=15
+   import pandas.util.testing as tm
+
+*************
+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: 1
+
+   /source/whatsnew/v0.23.2.txt
+   whatsnew/v0.23.1.txt
+   whatsnew/v0.23.0.txt

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