Add a link to the HOWTO into the mailman footer? Barry
On 1 Dec 2019, at 15:45, C. Titus Brown <ctbrown@UCDAVIS.EDU> 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 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/ !?)
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.
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? :)
best, —titus
On Jul 29, 2019, at 8:38 AM, Guido van Rossum <guido@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 <cryptolabour@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-leave@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/NBILWW... 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-leave@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/DVUIY3... Code of Conduct: http://python.org/psf/codeofconduct/
_______________________________________________ Python-ideas mailing list -- python-ideas@python.org To unsubscribe send an email to python-ideas-leave@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/CO2673... Code of Conduct: http://python.org/psf/codeofconduct/