```python

```python def greet(name): """ 这个函数打印一个问候语。

参数: name: 要问候的人的名字。

返回值: None

示例: >>> greet("世界") 你好，世界！ """ print(f"你好，{name}！")

def add(x, y): """ 这个函数返回两个数的和。

参数: x: 第一个数字。 y: 第二个数字。

返回值: 两个数字的和。

示例: >>> add(2, 3) 5 """ return x + y

def factorial(n): """ 这个函数计算一个非负整数的阶乘。

参数: n: 要计算阶乘的非负整数。

返回值: n 的阶乘。

示例: >>> factorial(5) 120 """ if n == 0: return 1 else: return n * factorial(n - 1)

if name == "main": greet("世界") print(f"2 + 3 = {add(2, 3)}") print(f"5 的阶乘 = {factorial(5)}") ```

这是一个用 Python 编写的示例代码文档

这份文档包含三个函数：

1. greet(name): 该函数打印一个简单的问候语。
2. add(x, y): 该函数返回两个数字的和。
3. factorial(n): 该函数计算一个非负整数的阶乘。

每个函数都有一个 docstring，其中包含函数的描述、参数、返回值和示例。

使用 Docstring 生成文档

这份文档是使用 docstring 生成的，docstring 是一种在 Python 代码中嵌入的字符串，用于解释代码的功能。Docstring 应该被放在函数、类或模块的开头。

使用 docstring 的优点：

• 提高代码的可读性。
• 方便使用文档工具生成文档。
• 允许使用 help() 函数查看函数的帮助信息。

总结

这份文档展示了如何使用 docstring 来编写 Python 代码文档，并说明了 docstring 的优点。建议在编写代码时使用 docstring 来提高代码的可读性和可维护性。