Главная
Study mode:
on
1
Intro
2
Jacob Deppen
3
Why does documentation matter
4
Values of documentation
5
Who am I
6
Who am I not
7
Why this tutorial
8
The workflow
9
Sphinx
10
Pros to Sphinx
11
Sticky Notes
12
Clone to local machine
13
Setup environment
14
Explore code
15
Documentation level 1
16
Type annotations
17
Pros Cons
18
Practice module
19
Return type
20
Invalid type
Description:
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.

Documenting Your Code From Docstrings to Automated Builds

PyCon US
Add to list
0:00 / 0:00