On 12 October 2015 at 13:08, Nick Coghlan <ncoghlan@gmail.com> wrote:
On 11 October 2015 at 22:33, Nick Coghlan <ncoghlan@gmail.com> wrote:
Based on the thread a few weeks ago and the subsequent issue tracker discussion at http://bugs.python.org/issue25194, I just committed an initial version of a "Motivations & Affiliations" page in the developer guide.
When the site next updates, that should appear at https://docs.python.org/devguide/motivations.html (it's the last section in the main TOC, with the link appearing right at the bottom of the main page).
It's been pointed out that despite the excellent feedback I received from folks on the issue tracker, I still missed a few aspects of the translation away from the legalistic bureaucratese I used in my initial draft (see https://bugs.python.org/file40527/register-of-interests.diff ).
I'll do another pass on that, swapping out the more formal terms (e.g. "disclose") for more common plain English equivalents (e.g. "publish"). If there are other particular phrases and words that seem out of place, please let me know, either directly or here in the thread, as I sometimes lose track of what counts as normal English and what's specifically corporate/institutional English :)
Further off-list feedback: this initial version of the page doesn't do a good job of explaining what the *point* of the page is. While that did get covered in the original python-committers thread and the issue tracker discussion, and is also covered to some degree in the instructions-for-developers in the page source, that doesn't help folks *reading* the page.
I've noted that as a pending update in https://bugs.python.org/issue25194
Regards, Nick.
-- Nick Coghlan | ncoghlan@gmail.com | Brisbane, Australia