On 16/08/2019 05:31, Kyle Stanley wrote: > Yeah definitely, it was my intention to mention this in the devguide, > particularly with adding an example of the Sphinx roles being used and > explaining appropriate usage. I hadn't thought of linking to the list of > roles (https://devguide.python.org/documenting/#id4), but that's definitely > a good idea to include. I was just waiting for everyone to get a chance to > provide feedback on the topic before expanding the devguide. > > After the devguide is updated, I was also planning on adding the markup to > 3.8's Misc/NEWS entries (in the appropriate branch, as Ned recommended), > and then work on the 3.9. I'll probably split it into several smaller PRs > so it's easier to review.
There has been "a lot" of discussion re: things for new contributors to do and learn. a) this seems to be "well-defined", and imho, suitable as "easy", etc.. b) isn't this something we want new people to be more aware of (as you said, you have been working with this for a year) c) it is an area (Documentation) I have clearly 'missed' as I focused on 'other things', and, with myself and many projects I have worked on over the years - Documentation seems to come in last. Getting new (and newish, as myself) working here only makes us better suited for review in the future. So, I guess this is an area where you could "mentor", perhaps create "issues" that specify the "paragraphs", or whatever you think are appropriate 'chunks' to make review sensible (if not also easier). Michael
signature.asc
Description: OpenPGP digital signature
_______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/T5YQW2I624S7UU63AXNBNGOH7ASF6OWC/
