On Sun, Jul 5, 2015 at 6:06 PM, Nick Coghlan <ncoghlan@gmail.com> wrote:
On 6 July 2015 at 03:52, R. David Murray <rdmurray@bitdance.com> wrote:
Just so people aren't caught unawares, it is very unlikely that I will have time to be the final editor on "What's New for 3.5" they way I was for 3.3 and 3.4.
And thank you again for your work on those!
I've tried to encourage people to keep What's New up to date, but *someone* should make a final editing pass. Ideally they'd do at least the research Serhiy did last year on checking that there's a mention for all of the versionadded and versionchanged 3.5's in the docs. Even better would be to review the NEWS and/or commit history...but *that* is a really big job these days....
What would your rough estimate of the scope of work be? As you note, the amount of effort involved in doing a thorough job of that has expanded beyond what can reasonably be expected of volunteer contributors, so I'm wondering if it might make sense for the PSF to start offering a contract technical writing gig to finalise the What's New documentation for each new release.
I think I might be able to "volunteer" for the task of writing/editing the "What's New in 3.5" docs. I saw David's comment on it today, so obviously haven't yet had a chance to run it by my employer (Continuum Analytics), but I have a hunch they would allow me to do it at least in large part as paid time. I am experienced as a technical writer, follow python-dev, write about new features, but am *not*, however, my self an existing core developer. If there is interest in this, or at least it seems plausible, I can run it by my employer tomorrow to see about getting enough time allocated (using David Murray's past experience as a guideline for what's likely to be needed). Yours, David... -- Keeping medicines from the bloodstreams of the sick; food from the bellies of the hungry; books from the hands of the uneducated; technology from the underdeveloped; and putting advocates of freedom in prisons. Intellectual property is to the 21st century what the slave trade was to the 16th.