成功模式(pattern)作家的七个习惯(3)(by GOF)

习惯三：开始时做得更具体(Being Concrete Early)

在我们的模式中，“意图”部分表现得更直接明了(up-front)。
这是因为人们对先提出具体的术语，然后才是抽象术语理解得
更好一些。“意图”部分的具体例子给读者一个问题的参考和
解决方案的框架。这个部分演示的另一个方面是为什么其它对
这个问题的解决方法失败了，同样用具体的术语。把“意图”
部分作为一个介绍，读者能更好的理解(appreciate)通用的解决
方案。

具体化的直接结果是需要从真实世界中来的大量例子。例子
不应该是“意图”部分所独有的财产。在整个模式中使用例
子和反例(counterexample)描绘了关键点。即使是我们模板
中最抽象的部分(如“适用性”，“结构”，“参与者”，和
“协作”)有时也有例子。举个例子，有些“协作”部分包括
表示对象在运行时怎样通信的交互图(interaction diagrams)。
在讨论模式的抽象部分参考这些例子－－－即是在你抽象时
也要具体点。

另一个直接结果可能是术语：“告诉别人整个真实情况”
(telling the whole truth)。这意味着你必须提醒你的
读者这个模式的潜在的缺点(pitfalls)。很容易对优点
部分喋喋不休；不容易理解它们的缺点并且真诚的谈论
这些缺点。没有一个模式是完全没有缺点的，或额外的
开销，或在特定环境下的不良表现的，等等。确保你的
读者懂得这个模式会有缺点(fall short)。