关于ruamel.yaml文档indent示例中y字段来源的技术疑问

问题背景 #

原始YAML内容：

x:
- b: 1
- 2

ruamel.yaml官方文档提到，使用配置yaml.indent(mapping=2, sequence=4, offset=2)处理后，示例输出为：

x:
  y:
    - b: 1
    - 2

疑问：示例里新增的y字段是哪来的？

解答 #

这是官方文档的笔误：

• yaml.indent()方法仅负责调整映射、序列的缩进规则，完全不会自动生成或新增字段。
• 针对原始YAML，正确的缩进后结果应该是保留x直接关联序列的结构，仅调整序列项的缩进，如下：

x:
  - b: 1
  - 2

大概率是文档编写时混淆了不同示例的内容，误把包含y字段的其他示例放到了这里。

内容的提问来源于stack exchange，提问作者Tommy