git-who项目帮助文档的优化与使用指南

git-who是一个实用的Git扩展工具，它能够帮助开发者快速查看代码库中各个文件的最后修改者信息。近期该项目对其帮助文档系统进行了重要优化，使新用户能够更直观地了解工具的全部功能。

帮助系统的层级结构

git-who采用了层级化的帮助系统设计。当用户直接运行git who -h时，只会显示最基础的帮助信息。这种设计理念类似于Git本身的多级命令结构，旨在避免一次性展示过多信息造成用户认知负担。

新增的帮助提示

在最近的更新中，git-who在基础帮助信息中明确添加了提示，告知用户可以通过git who <subcommand> -h的形式获取特定子命令的详细帮助。这一改进显著提升了工具的易用性，特别是对于初次接触该工具的开发人员。

完整的命令功能

git-who实际上提供了多个子命令，每个都有特定的用途：

• table子命令：以表格形式展示文件修改者信息
• tree子命令：以树状结构展示文件修改者信息
• -l选项：显示完整的文件路径信息

使用建议

对于新用户，建议首先运行git who -h了解基本用法，然后针对特定子命令查询详细帮助。例如：

1. 查看表格形式输出的帮助：git who table -h
2. 查看树状结构输出的帮助：git who tree -h
3. 了解路径显示选项：在子命令帮助中查找-l选项说明

这种渐进式的帮助系统设计既保持了界面的简洁性，又确保了用户能够获取所需的全部功能信息。