Polly文档导航优化：解决主分类页面访问不便问题

Polly作为.NET生态中广受欢迎的弹性库，其文档网站近期被发现存在一个影响用户体验的导航问题。本文将深入分析该问题的本质、产生原因以及最终解决方案。

问题背景

在Polly文档网站中，用户无法直接访问诸如"Resilience pipelines"、"Chaos engineering"等主分类页面。这些页面只能通过一个迂回的方式访问：首先点击对应分类的下拉菜单中的某个子页面，待页面加载完成后，再通过面包屑导航返回主分类页面。

这种设计给用户带来了明显的困惑，使得整个文档结构显得不完整，仿佛缺少了对各个主题的介绍页面。从用户体验角度看，这违背了文档网站应有的直观性和易用性原则。

技术分析

该问题本质上源于文档网站的表单结构(toc.yml)配置不够完善。在文档系统中，面包屑导航通常是根据表单结构自动生成的，而主分类页面未被正确设置为可独立访问的入口点。

具体表现为：

1. 主分类页面虽然存在(如chaos/index.html)，但未在导航菜单中提供直接链接
2. 用户必须经过二级页面才能"发现"主分类页面的存在
3. 面包屑导航的显示顺序与常规逻辑相反，进一步增加了认知负担

解决方案

开发团队经过讨论后确定了两种可能的改进方案：

1. 无下拉菜单方案：在左侧导航栏中直接显示主分类链接，不采用下拉菜单形式。这种方案的优势是结构清晰，用户可以直接点击进入主分类页面。

2. 保留下拉菜单方案：保持现有下拉菜单结构，但优化面包屑导航。这种方案需要为主分类页面设置不同于父级名称的标识，以避免面包屑导航显示混乱。

最终团队选择了第一种方案，因其提供了更直观的导航体验。实现方式是通过更新文档的表单结构(toc.yml)文件，在每个下拉菜单顶部添加摘要主题链接。

改进效果

这一优化显著提升了文档网站的可用性：

• 用户现在可以直接访问各主分类的介绍页面
• 文档结构更加清晰完整
• 减少了用户寻找关键信息的操作步骤
• 消除了面包屑导航的混乱现象

对于开源项目而言，良好的文档体验与代码质量同等重要。Polly团队对此问题的快速响应和解决，体现了对用户体验的重视，也为其他开源项目的文档建设提供了有价值的参考。