知识卡片
一概念约定一称谓
团队应为同一种概念约定稳定称谓,减少读者猜测fetch、retrieve和get有何区别。可进一步约定get查单个、list查多个、page分页、count计数。真正不同的契约仍应在命名或接口说明中区分,不能为统一词形抹掉行为差异。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 一概念约定一称谓
原书出处 · 1 处
- · 查看原书依据
每个概念对应一个词,并且一以贯之。例如,fetch、retrieve、get、find和query都可以表示查询的意思,如果不加约定地给多个类中的同种查询方法命名,你怎么记得是哪个类中的哪个方法呢?同样,在一段代码中,同时存在manager、controller和han
参考来源
- 位置:《代码精进之路:从码农到工匠(异步图书)》1.4.1 每个概念一个词(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u016-ch01-009)。
- 结论依据:原文在“每个概念对应一个词”附近的定义、实例或代码支撑本卡的核心说明:团队应为同一种概念约定稳定称谓,减少读者猜测`fetch`、`retrieve`和`get`有何区别。适用边界按该处前提解释,代码未执行。
- 原始内容:每个概念对应一个词,并且一以贯之。例如,fetch、retrieve、get、find和query都可以表示查询的意思,如果不加约定地给多个类中的同种查询方法命名,你怎么记得是哪个类中的哪个方法呢?同样,在一段代码中,同时存在manager、controller和han