提示5-5:描述每个(重要)黑盒的责任或目的!
#building-block #blackbox #essential
除了一个富有表现力或有意义的名称外,对其责任的简要描述属于积木视图的真正重要方面。
如果名称以某种方式引用了相应黑盒满足的要求,它们可能会变得非常清晰。
描述黑框做或执行什么,避免描述“如何”。
特别是在构建块层次结构的较低级别中,单个黑箱履行了一些更高级别的构建块的部分责任。
保持这种描述简洁紧凑,最多一两句话。此类描述中有太多的“和”可能是抽象缺失的标志。
命名属于计算机科学中最难的两件事——除了缓存失效和逐一错误。