知识卡片
共享术语可压缩注释
读者熟悉的技术术语可以把一段重复描述压缩为明确角色,例如缓存层或地址规范化。选择术语前应确认它准确对应实际行为,必要时保留短例解释范围。术语若陌生或多义,单纯换成长词并不会减少理解成本;精简不能损失关键条件。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
专门的词或短语来描述这种模式/定式。使用这些词会让你的注释更加紧凑。 例如,假设你原来的注释是这样的: 那么你可以简单地说: 另一个注释的例子: 可以写成: 很多词和短语都具有多种含义,例如"heuristic"、"bruteforce"、"naive solution
参考来源
- 位置:《编写可读代码的艺术》用共享术语压缩重复说明(spine 2812;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2736.html`;来源键`s2812-ch06-007`)。
- 结论依据:本项正文与图132..158完整实读;按图核对参数、边界与返回索引,不把教学片段当完整实现或已执行测试。
- 原始内容:专门的词或短语来描述这种模式/定式。使用这些词会让你的注释更加紧凑。 例如,假设你原来的注释是这样的: 那么你可以简单地说: 另一个注释的例子: 可以写成: 很多词和短语都具有多种含义,例如"heuristic"、"bruteforce"、"naive solution