Đang chuẩn bị liên kết để tải về tài liệu:
Technical Writing Made Easier

Technical writing requires clarity of expression and therefore simplicity of language. Technical writing is intent on expressing certain key concepts so that these may be understood as easily as possibly by the intended readers — be they programmers or users. Writing in a clear, concise manner makes not only understanding the text easier for the reader, it also makes your life as a writer of technical documentation easier — especially when you are not a native speaker of English. | Technical Notes general Series Technical Writing made easier rev. 1.1 March 2002 by Bernhard Spuida bernhard@icsharpcode.net Senior Word Wrangler Bernhard Spuida 2002 1 Table of Contents 1. Introduction.2 2. Theory.2 3. Readability.3 3.1 Well formed Sentences.3 3.2 Overlong Sentences.4 3.3 Short Sentences.4 3.4 Recursion.4 3.5 Choice of Words.5 4. Comprehensibility.5 4.1 Definition.6 4.2 Assumption Theorem.6 4.3 Explanation Proof.6 4.2 Conclusion.6 5. Matters of Style.8 5.1 Title.8 5.2 Big Words.8 5.3 It s.9 5.4 An a .9 5.5 Do not use don t .9 5.6 Can could etc.9 5.7 Nativisms.10 5.8 Ego Trip.10 5.9 When to use if .10 5.10 This Sentence does overdo it.10 5.11 Time is on our side.11 5.12 Consistency.11 5.13 Editor s pet peeves.11 5.13.1 Grammar and Logic.11 5.13.2 Spelling and Terminology.12 6 Recommended Reading.15 7 Online Resources.15 Bernhard Spuida 2002 2 1. Introduction Technical writing requires clarity of expression and therefore simplicity of language. Technical writing is intent on expressing certain key concepts so that these may be understood as easily as possibly by the intended readers be they programmers or users. Writing in a clear concise manner makes not only understanding the text easier for the reader it also makes your life as a writer of technical documentation easier especially when you are not a native speaker of English. When talking about algorithms or sequences of events in a program absolute clarity of writing is not only needed in the code discussed but also in documenting this particular program for our fellow programmers and users. We need to attain the same level of clarity of expression in both cases otherwise readers will to turn to other programs which are more accessible on the level of understanding and therefore easier to use or extend. In this short guide we will cover some of the basic concepts that lead to good technical writing. You will certainly discover more such rules and concepts as you practice the writing skills .