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

习惯五：有效的表达。(Presenting Effectively)

你的模式的质量取决于你表达它们好不好。你可能
发现世界上最好的模式，但它将不会帮助任何人除非
你有效的表达它们。

用“表达“(presenting)这个词我表示两件事:打印
设置(typesetting)和写作风格。好的打印设置是
页面设置(page layout),预览打印(typography),
图象(graphics)的技巧的事，而不管打印机质量。
使用你能得到的最好的软件工具(文字处理，画图
编辑器，等等)。用正规的(liberal)画图使用表达
你的关键点。你可能不会想到需要任何画图，但
只要有机会就那么做。至少它们去处枯燥，最好的情
况下它们能使你得到无论多少文字解释都无法得到
的表现效果。不必所有的画图都要有正式的类图
和对象图。非正式的画图，甚至草图常常能表达
相同和甚至更多的信息。如果你被“艺术性的被
挑战”(artistically challenged)了,那么让
别人为你画这个图。

好的写作风格比好的打印设置更重要。清楚的和
真实的(unpretentiously)写作。喜欢脚踏实地
的(down-to-earth)风格,而不是陈旧(stuffy)
和学术(academic)的风格。人们理解和喜欢
(appreciate)一个对话性的腔调，这个腔调
让它们对材料更容易被接受(receptive)。
在大多数作品中清楚明了和易于阅读是很重要的，
不过它们在模式写作中特别的重要。模式概念
太新并且主题问题太复杂，以至于有些人
很难弄懂它的所有要点。所有让模式友好
(approachable)的工作都应该做。

最好的学习怎么用对话式的方式写作的方法
是试着去做。确保你所写的所有东东是
你能听到你自己对朋友所说的。避免用
被动的腔调(passive voice)。打破长句子
和段落。使用日常用语，不要害怕使用
缩略语(contractions)。综上所述，让它
听上去自然些。

另一件每个人在生活的同一点要做的是读
一本或两本关于“写作风格”的书。有很多
可供选择的。我最喜欢的3本是Strunk和
White的<<The Elements of Style(whose
organization,remarkbly,is not unlike
a series of patterns)>>,Joseph M
Williams的<<Style:Ten Lessons in Clarity
and grace>>和John R. Trimble的<<Writing
with Style:Conversations on the Art of
Writing>>。像这些一样的书有为了好的，清楚
的写作的技巧。它们能帮助你不管模式的技术内
容而改进你的模式。