成功模式(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>>。像这些一样的书有为了好的，清楚

的写作的技巧。它们能帮助你不管模式的技术内

容而改进你的模式。