On 12/1/19 10:45 AM, C. Titus Brown wrote:
Hi folks,

sorry, took me more than a few months, but I wrote a draft of a python-ideas 
HOWTO here,

https://hackmd.io/@-6xkuCDkTrSFptQEimAdcg/B1noEGh2H

Thanks so much for writing this. I think Python-Ideas is a perfect example of something that could use an introduction, so that peoples' expectations are properly set.

Thanks to Eric Smith and Chris Barker for their link suggestions, and Chris 
Angelico and Guido van Rossum for their additional thoughts in a brief off-list 
thread.

SO. The question becomes, where do we host this?

I received the strong suggestion from both Guido and Stephen Turnbull that it 
should be in the devguide (see quoted message from GvR below).

But, when I finished this draft and went to look at the devguide repo, realized 
that the devguide at https://devguide.python.org/ may not be the best place to 
host it, because (as written) the dev guide is VERY focused on code 
development. I think this HOWTO is a bit more community and process oriented 
than the current top-level materials in the dev guide.

So instead of submitting a PR, I am appealing to the list for your thoughts.

The three easiest options I see are:

1. Put it on python.org, perhaps replacing the content here: 
https://www.python.org/dev/. I can’t figure out where that content is hosted 
(it’s not in https://github.com/python/pythondotorg/ !?)

To me, the audience for the Python-Ideas HOWTO is very different than for /dev/: the people suggesting ideas are not necessarily proposing to implement the ideas. They definitely are not (yet) interested in the process of developing CPython.  This is doubly true for the people who really need to read the HOWTO.


2. put it in the current dev guide somewhere, just so it lands in version 
control. Then iterate on both it and the dev guide. My first thought would be 
to merge the content with this document, 
https://github.com/python/devguide/blob/master/langchanges.rst.
Again, the devguide will not be an obvious place for people to stumble across the HOWTO.

3. put it somewhere near the front of the current dev guide, and do more work 
to adjust the dev guide.

Thoughts? Am I missing am obvious location? Should I just get on with a PR and 
we’ll sort it out later? :)

There is a page that catalogs the mailing lists: https://www.python.org/community/lists/ .  A new page linked from the Python-Ideas description (which is very brief!) sounds good to me.

Thanks again for doing this!

--Ned.



best,
—titus

On Jul 29, 2019, at 8:38 AM, Guido van Rossum <gu...@python.org> wrote:

I suggest to put this in the devguide and deep-link there from the python-ideas 
(and python-dev?) description. The more we have under version control the 
better. There shouldn't be a need for too much bikeshedding on the first 
iteration -- just get a simple PR (along the lines of what you wrote) up (you 
can ping me for review) and once it's merged you can link to it; we can then 
easily iterate on the contents if there seems to be a need for additional 
suggestions.

On Mon, Jul 29, 2019 at 8:13 AM Ai mu <cryptolab...@gmail.com> wrote:
Hosting? I suggest Python wiki

Abdur-Rahmaan Janhangeer
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/NBILWWRZ46G2WUB3EHSZMII5V7B4IYD6/
Code of Conduct: http://python.org/psf/codeofconduct/


--
--Guido van Rossum (python.org/~guido)
Pronouns: he/him/his (why is my pronoun here?)
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/DVUIY3FCDB5VXD65NEXSVPZL5WEZRDWC/
Code of Conduct: http://python.org/psf/codeofconduct/
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/CO2673SSPEIQNCRYRAPH5VITQ7KQOOGQ/
Code of Conduct: http://python.org/psf/codeofconduct/
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/C4PL6PLNWZ3L44BFT7YJNDCCTPHRYAZD/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to