Wagtail文档重构：优化页面模型参考结构

Wagtail作为一款优秀的开源CMS系统，其文档体系对于开发者体验至关重要。近期社区对文档结构中的"Reference > Pages"部分进行了重要调整，使内容组织更加合理清晰。

文档结构调整背景

Wagtail文档原有的"Reference > Pages"部分存在一些结构性问题。虽然命名为"Pages"，但实际上包含了不专属于页面模型的通用内容，这给开发者特别是新用户带来了困惑。主要问题包括：

1. "Panel types"文档虽然放在页面参考下，但面板系统实际上支持Snippets和Pages等多种模型
2. "Model reference"文档包含了所有模型参考，而不仅限于页面模型
3. 部分文档标题大小写不一致，影响专业性和一致性

重构方案与实施

社区经过讨论确定了以下优化方案：

1. 通用内容迁移：将"Panel types"和"Model reference"两个通用文档从"Pages"子目录移至"Reference"主目录下，使其位置更符合内容性质

2. 标题规范化：将"Model Reference"改为"Model reference"，采用更一致的小写字母风格，与其他文档标题保持统一

3. 标签系统分离：原"Recipes"文档中的标签(tagging)相关内容被提取出来，单独创建"Tags"文档，放在"Advanced topics"部分，使内容分类更加明确

4. 标题层级修复：修正了"Recipes"文档中标题层级不正确的问题，确保文档结构清晰

5. 代码标注优化：将文档中的wagtail.models等代码引用改为双反引号格式，使其在渲染后的文档中正确显示为代码样式

技术细节优化

在重构过程中，特别关注了几个技术细节：

1. 移除了wagtail.models模块中不适当的文档字符串，这些内容原本是给Wagtail核心开发者看的内部说明，不应出现在面向用户的API文档中

2. 为旧版本文档设置了重定向规则，确保从旧链接访问的用户能够被正确引导到新位置，保持向后兼容性

3. 对文档中的代码示例和引用进行了统一格式化，提升可读性

对开发者的影响

这次文档重构为Wagtail开发者带来了更好的使用体验：

1. 更直观的导航：现在开发者可以更直观地找到页面模型相关的参考文档，而通用内容也有了自己的位置

2. 更清晰的分类：标签系统等高级功能有了专属文档，便于开发者深入学习

3. 更一致的风格：统一的标题风格和代码标注使文档看起来更加专业

4. 更好的维护性：结构调整后的文档体系更易于维护和扩展

这次文档优化体现了Wagtail社区对开发者体验的持续关注，通过不断改进文档结构，降低新用户的学习曲线，提升所有开发者的工作效率。