Thread: [matplotlib-devel] whats_new and api_changes

Fellow developers,
I know we are now encouraged when writing a PR not to alter
doc/users/whats_new.rst and doc/api/api_changes.rst directly, but rather to
create files in the doc/users/whats_new and doc/api/api_changes directories
instead. When building the master branch docs I was expecting the contents
of these new files to be automagically incorporated in the appropriate doc
sections, but this does not happen on my development system (ubuntu 14.04,
python 2.7, sphinx 1.2.2).
I figure either I am doing something wrong, or this is a bug, or there is
manual process at release time to cut and paste the new files into the
parent files. Which is it?
Ian

There should be an automatic process, but no one has written it yet. I
think IPython has code we can adapt in their doc build process. I had
planned to deal with this when we cut the next minor/major release.
Tom
On Thu, Nov 27, 2014, 04:18 Ian Thomas <ian...@gm...> wrote:
> Fellow developers,
>
> I know we are now encouraged when writing a PR not to alter
> doc/users/whats_new.rst and doc/api/api_changes.rst directly, but rather to
> create files in the doc/users/whats_new and doc/api/api_changes directories
> instead. When building the master branch docs I was expecting the contents
> of these new files to be automagically incorporated in the appropriate doc
> sections, but this does not happen on my development system (ubuntu 14.04,
> python 2.7, sphinx 1.2.2).
>
> I figure either I am doing something wrong, or this is a bug, or there is
> manual process at release time to cut and paste the new files into the
> parent files. Which is it?
>
> Ian
> ------------------------------------------------------------
> ------------------
> Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
> from Actuate! Instantly Supercharge Your Business Reports and Dashboards
> with Interactivity, Sharing, Native Excel Exports, App Integration & more
> Get technology previously reserved for billion-dollar corporations, FREE
> http://pubads.g.doubleclick.net/gampad/clk?id=157005751&
> iu=/4140/ostg.clktrk_______________________________________________
> Matplotlib-devel mailing list
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>

On 27 November 2014 at 16:16, Thomas Caswell <tca...@gm...> wrote:
> There should be an automatic process, but no one has written it yet. I
> think IPython has code we can adapt in their doc build process. I had
> planned to deal with this when we cut the next minor/major release.
>
> Tom
>
Thanks for letting me know Tom.
Ian

For reference, the IPython script is in tools/update_whatsnew.py
On Thu Nov 27 2014 at 11:58:40 AM Ian Thomas <ian...@gm...> wrote:
> On 27 November 2014 at 16:16, Thomas Caswell <tca...@gm...> wrote:
>
>> There should be an automatic process, but no one has written it yet. I
>> think IPython has code we can adapt in their doc build process. I had
>> planned to deal with this when we cut the next minor/major release.
>>
>> Tom
>>
>
> Thanks for letting me know Tom.
>
> Ian
>