CPython Documentation: The Next 5 Years

Slide 1

Slide 1 text

@WillingCarol Documentation The Next 5 Years Python Language Summit April 15, 2020 Carol Willing Ned Batchelder 1

Slide 2

Slide 2 text

@WillingCarol Documentation Governance in a Post-BDFL World 2

Slide 3

Slide 3 text

@WillingCarol 3 Creating documentation responsibly to grow Python's world usage and meet community needs

Slide 4

Slide 4 text

@WillingCarol 4 Users' needs differ Web DevOps Systems Testing Science Data Science Micropython, CircuitPython, Raspberry Pi Education Embedded systems Universal Need Understanding --> Application and have evolved over Python's lifetime

Slide 5

Slide 5 text

@WillingCarol Our time is limited 5

Slide 6

Slide 6 text

@WillingCarol Community scales 6 Python Brasil official photo. The sign represents Python in BSL (Brazilian Sign Language), made by Amanda and Sávio at Python Sul 2018 https://pyfound.blogspot.com/2019/02/python-brasil-people-technology.html PyLadiesBRConf official photo PyLadiesBRConf official photo

Slide 7

Slide 7 text

@WillingCarol Documentation Editorial Board as a Python Steering Council Workgroup 7

Slide 8

Slide 8 text

@WillingCarol Editorial Board 8 Assets Style and Tone Guides Language Translations Presentation - Landing Page

Slide 9

Slide 9 text

@WillingCarol Python Documentation Governance 9 ‣ Quality and Stability ‣ Contributing inclusive and sustainable ‣ Community ownership ‣ Editorial Board (community members and core devs with strong documentation and communication experience) ‣ Decision making processes ‣ Seek consensus

Slide 10

Slide 10 text

@WillingCarol Getting Started 10 Governance and workgroup Tutorials Language translations Landing Page Year 1

Slide 11

Slide 11 text

@WillingCarol Measure and grow 11 Evaluate effectiveness Documentation sprints Annual editorial review Years 2 - 5

Slide 12

Slide 12 text

@WillingCarol 12 Thank you