Class Central is learner-supported. When you buy through links on our site, we may earn an affiliate commission.

YouTube

Documenting Your Code From Docstrings to Automated Builds

PyCon US via YouTube

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

Reviews

Start your review of Documenting Your Code From Docstrings to Automated Builds

Never Stop Learning.

Get personalized course recommendations, track subjects and courses with reminders, and more.

Someone learning on their laptop while sitting on the floor.