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

    技术2022-05-11  110

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

    最新回复(0)