知识卡片
用备选名比较暴露误解
选名时把多个候选写进同一真实调用或配置行,站在不知道实现的读者角度列出合理误读,再比较谁能说清对象、方向和数值含义。试验继承例中,copy:100可能像复制100次,inherit_from_experiment_id则更明确引用来源。方法是比较具体解读,不是给所有功能套最长名字。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
要想象一下对于看到这段代码却又不知道这个功能的人来讲,这个名字听起来是什么意思。因此我们要分析每一个名字,考虑各种让人误解的可能性。 1.让我们想象一下使用这个名字模板时的情形: template有两个问题。首先,我们不是很清楚它的意思是“我是一个模板”还是“我在用其他
参考来源
- 位置:《编写可读代码的艺术》比较备选名字来找误解(spine 2783;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2707.html`;来源键`s2783-ch03-006`)。
- 结论依据:本项正文与图53..76完整实读;区分名称约定、真实实现契约及旧版本性能例,不复制原文已识别的均值/中值笔误。
- 原始内容:要想象一下对于看到这段代码却又不知道这个功能的人来讲,这个名字听起来是什么意思。因此我们要分析每一个名字,考虑各种让人误解的可能性。 1.让我们想象一下使用这个名字模板时的情形: template有两个问题。首先,我们不是很清楚它的意思是“我是一个模板”还是“我在用其他