习惯五:有效的表达。(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>>。像这些一样的书有为了好的,清楚
的写作的技巧。它们能帮助你不管模式的技术内
容而改进你的模式。