Overview
Learn essential documentation techniques for Python projects in this comprehensive tutorial. Explore the fundamentals of effective documentation, from writing clear docstrings and adding type hints to creating user-friendly interfaces with JupyterBook and Jupyter Notebooks. Master the use of Sphinx for building API documentation and automate the publishing process with GitHub Actions and GitHub Pages. Gain valuable insights into maintainer-friendly workflows and best practices for documenting code at various stages of development. Suitable for both beginners and experienced developers, this tutorial covers a wide range of topics, including code comments, type annotations, and advanced documentation tools, to help you create and maintain high-quality documentation for your Python projects.
Syllabus
Intro
Jacob Deppen
Why does documentation matter
Values of documentation
Who am I
Who am I not
Why this tutorial
The workflow
Sphinx
Pros to Sphinx
Sticky Notes
Clone to local machine
Setup environment
Explore code
Documentation level 1
Type annotations
Pros Cons
Practice module
Return type
Invalid type
Taught by
PyCon US