I think that each entry should also have a link to the underlying PR on
GitHub using the `#2345` notation everyone is familiar with.


On Tue, Aug 20, 2013 at 3:09 PM, Thomas Kluyver <notifications@github.com>wrote:

> In docs/source/whatsnew/pr/README.md:
>
> > @@ -0,0 +1,18 @@
> > +Documenting What's New
> > +----------------------
> > +
> > +When making a new pull request that either adds a new feature, or makes a
> > +backwards-incompatible change to IPython, please add a new `.rst` file in this
> > +directory documenting this change as a part of your Pull Request.
> > +
> > +This will allow multiple Pull Requests to do the same without conflicting with
> > +one another. Periodically, IPython developers with commit rights will run a
> > +script and populate [development.rst](../development.rst)
> > +with the contents of this directory, and clean it up.
> > +
> > +Files which describe new features can have any name, such as
> > +`antigravity-feature.rst`, whereas backwards incompatible changes **must have**
>
> Our intention is that these files are just a temporary thing, and they're
> automatically put into the real what's new doc every few days, and
> certainly before the release. We're just frustrated by all our pull
> requests conflicting with one another.
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/ipython/ipython/pull/4070/files#r5882722>
> .
>



-- 
Brian E. Granger
Cal Poly State University, San Luis Obispo
bgranger@calpoly.edu and ellisonbg@gmail.com