注释应解释‘什么’：代码可读性的新视角

文章挑战了传统观点‘注释应解释为什么，而非什么’，通过实例分析短变量名（如w、r）导致的上下文混淆问题。作者指出，查找信息耗时且易出错，而过度依赖方法分解可能增加上下文切换。在特定场景下，注释解释‘什么’能提升代码可读性，避免危险假设。强调注释需服务于上下文平衡，而非机械遵循教条，这对AI辅助编程和GitHub协作具有实际指导意义。