Rust文档工具中Span结构体行号索引的修正说明

在Rust生态系统中，rustdoc-types库作为文档生成工具的重要组成部分，其Span结构体用于表示源代码中的位置范围。最近发现该结构体文档中关于行号索引的描述存在不准确之处，需要进行修正。

Span结构体包含两个关键字段：begin和end，它们都是包含两个元素的数组。按照原文档描述，这两个字段应该是"零索引"的，即第一行应该标记为0。然而实际测试表明，该描述与实现行为不符。

通过一个简单的测试用例可以验证这个问题。当处理包含"pub mod bbb {}"的源代码文件时，rustdoc生成的JSON输出显示，模块bbb的span范围是从第1行开始的，而不是文档声称的第0行。这种文档与实际行为的不一致可能会给开发者带来困惑。

这个问题的影响范围主要涉及使用rustdoc-types库进行源代码位置处理的工具链。虽然不影响核心功能，但准确的文档对于开发者正确理解和使用API至关重要。

该问题已经被项目维护者确认并修复。修正后的文档将准确反映Span结构体的实际行为，即行号索引从1开始计数。这一改动将提升开发者在处理源代码位置信息时的体验，避免潜在的误解。

对于Rust工具链开发者而言，这个案例提醒我们在编写文档时需要确保描述与实现严格一致。特别是在处理类似索引这样的基础概念时，任何微小的不一致都可能导致使用者的困惑。