本文是 Jupyter 仓库中 IPython 开发指南的组成部分，讲解 IPython 及其衍生项目（包括 Jupyter 文档体系）中「如何写文档」的完整约定：从独立文档的 reStructuredText 格式与 Sphinx 构建流程，到面向用户 API 的 NumPy 风格 Docstring，再到文档发布（gh-pages）的操作步骤。

Sphinx 的 sphinx.ext.napoleon 扩展（自 Sphinx 1.3 引入，模块作者为 Rob Ruana）让你可以直接在源码中按 Google Python Style Guide 或 NumPy docstring 标准 书写 docstring，而不必手写繁琐的 reStructuredText 字段。Napoleon 是一个 预处理器 ：它在 Sphinx ...

The fundamental package for scientific computing with Python. - Pull requests · numpy/numpy ...

A lightweight, powerful framework for multi-agent workflows - Releases · openai/openai-agents-python ...