Hackage为何存在两种布局？新版为何语法可读性更强？

为什么会存在两种布局？ #

Hackage的双布局源于文档生成工具的迭代和平台的逐步升级：

• 旧布局：多数来自传统Haddock工具的默认输出，早期Haddock的样式设计偏紧凑朴素，结构区分度低，没有适配现代化的浏览体验，像lazysmallcheck这类包的文档就属于这种情况。
• 新布局：是Hackage平台升级后推出的优化样式，配合新版Haddock或平台前端重构实现，base包的模块文档（比如GHC.Base、Data.List）用的就是这种新样式。

新布局可读性更强的核心原因 #

新布局从视觉和交互层面做了针对性优化：

• 清晰的视觉层级：侧边栏固定导航模块索引，函数签名用高亮样式和普通说明文本明确区分，不用反复滚动页面定位内容。
• 友好的排版细节：增加了合理的行高、段落留白，代码块采用高对比度的语法高亮，大幅降低长时间阅读的视觉疲劳。
• 适配性与交互优化：支持响应式布局（手机端也能正常浏览），部分模块文档还提供了折叠展开小节、快速跳转等功能。

为什么还有大量包用旧布局？ #

主要有几个常见原因：

• 这些包仍在使用旧版本的Haddock生成文档，未适配Hackage的新样式规范。
• 包维护者未更新文档构建配置，或者包处于低维护状态，没有跟进Hackage的平台升级。
• 少数包自定义了文档构建脚本的输出样式，没有采用Hackage提供的默认新模板。

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