BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//pretalx//pretalx.com//pyconde-pydata-2026//talk//37AESH
BEGIN:VTIMEZONE
TZID:CET
BEGIN:STANDARD
DTSTART:20001029T040000
RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10
TZNAME:CET
TZOFFSETFROM:+0200
TZOFFSETTO:+0100
END:STANDARD
BEGIN:DAYLIGHT
DTSTART:20000326T030000
RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=3
TZNAME:CEST
TZOFFSETFROM:+0100
TZOFFSETTO:+0200
END:DAYLIGHT
END:VTIMEZONE
BEGIN:VEVENT
UID:pretalx-pyconde-pydata-2026-37AESH@pretalx.com
DTSTART;TZID=CET:20260416T105500
DTEND;TZID=CET:20260416T112500
DESCRIPTION:This talk has one simple message: *please document your code*. 
 If you attend my talk\, you'll hear me explain why I praise documentation\
 , and why you should too. \n\nWhile writing documentation is generally ack
 nowledged to be a "good thing"\, most engineers do not document their work
 . I'll offer my optionated lament on the life and death of literate progra
 mming. A lament is a poetic discourse\, expressing sadness\, or feeling so
 rry about something. I'll give some examples of the *bad things* that can 
 happen when people don't write documentation.\n\nThen\, after making you f
 eel bad\, I'll give examples of how you can *feel good*. I'll explain why 
 writing documentation is a "good" edifying activity\, which helps you to b
 e a better person\, and make a better world.\n\nI'll review types of open 
 source documentation (Python and Unix)\, documentation frameworks (Diátax
 is)\, and Python tools (Sphinx\, Jupyter\, Quarto) you can try out as soon
  as my talk is finished.\n\nThen\, I'll get "cool n' futuristic" by talkin
 g about AI. I'll emphasise the importance of text to AI-assisted coding an
 d agentic workflows for "spec-driven development" (e.g. Agent-OS with Clau
 de Code)\, before tempering your excitement by giving you some old-fashion
 ed advice on "good" writing style by George Orwell.\n\nIn summary\, if you
  come to my talk\, you might experience an unusual mixture of sadness comb
 ined with hope. To conclude\, I'll tell you to "please document your code"
 . You'll laugh\, go to the next talk\, and forget my advice.
DTSTAMP:20260523T180013Z
LOCATION:Merck Plenary (Spectrum) [1st Floor]
SUMMARY:In Praise of Documentation: Tools\, Tips & Techniques for Literate 
 Programming in the AI Age - Stephen
URL:https://pretalx.com/pyconde-pydata-2026/talk/37AESH/
END:VEVENT
END:VCALENDAR