书单 | 有哪些技术传播从业者必知必看的书籍？

2. DITA Best Practices

书名：DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA

作者：Laura Bellamy, Michelle Carey, and Jenifer Schlotfeldt

出版社：IBM Press

DITA 即 Darwin Information Typing Architecture，专门用于支持基于 topic 的写作。那么，什么是 topic 呢？本书中的这句话很容易理解：

A topic is a self-contained unit of information. An effective topic covers only one subject. Each topic is long enough to make sense on its own, but short enough to stick to one point without expanding into other subjects.

DITA 主要提供三种类型的 topic：concept、task 和 reference。简单理解，也就是 How、What 和其它。这三种 topic 的用途和区别如下：

• A task topic describes one procedure.

• A concept topic defines what something is or how a process works.

• A reference topic contains one type of reference information that users might need as they perform tasks.

我之前做过蛮长一段时间的 DITA 写作，用的工具是 Arbortext，各种标签，轻便易上手。如果你想了解 DITA 的话，推荐这本书。

内容概览：

• Part I: Writing in DITA

• Part II: Architecting Content

• Part III: Converting and Editing

3. The IBM Style Guide

书名：The IBM Style Guide: Conventions for Writers and Editors

作者：Francis DeRespinis, Peter Hayward, Jana Jenkins, Amy Laird, Leslie McDonald, Eric Radzinski

出版社：IBM Press

这本书的内容特别详细，几乎涵盖了在技术写作中可能遇到的各种细节问题。写作时遇到有疑惑的地方不知道如何处理时，可以查阅一下此书作为参考。

关于这本书，我的建议是不必奢求一口气看完全记住。实践证明，这本书细到让你很快体会到头大的感觉，而且有些内容前后有一定的交叉重复。

更便捷更实用的使用方式是，掌握这本书的框架结构，哪个部分讲了什么内容，当你想查找某个问题的时候，能很快找到。当然，有些常用的基本规范还是要记住的。

先来看下章节目录感受一下吧~

内容概览：

• Language and grammar

• Punctuation

• Formatting and organization

• Structure

• References

• Numbers and measurements

• Computer interfaces

• Writing for diverse audiences

• Glossaries

• Indexes

4. The Chicago Manual of Style

书名：The Chicago Manual of Style: The Essential Guide for Writers, Editors, and Publishers

作者：University of Chicago Press Staff

出版社：University Of Chicago Press

这是一本相当大部头的书，同样具备字典属性，比 The IBM Style Guide 还要细。只 Punctuation 这一部分的目录就有三页之多。不要有压力，先来看下结构目录（以下二级目录只列了 Part Two 示例）：

内容概览：

Part One: The Publishing Process

Part Two: Style and Usage

• Grammar and Usage

• Punctuation

• Spelling, Distinctive Treatment of Words, and Compounds

• Names and Terms

• Numbers

• Abbreviations

• Foreign Languages

• Mathematics in Type

• Quotations and Dialogue

Part Three: Documentation

5. Microsoft Manual of Style for Technical Publications

书名：Microsoft Manual of Style for Technical Publications

作者：Microsoft Corporation Editorial Style Board

出版社：Microsoft Press

顾名思义，这本书是 Microsoft 的 Style Guide。当然，跟 IBM 的类似，也很详细。这本书的 Part 1 包含 12 章；Part 2 是个 Usage Dictionary，即用词规范。例如：

canceled, canceling One l, but use two l’s in the noun cancellation.

内容概览：

Part 1: General Topics

• Documenting the User Interface

• Content Formatting and Layout

• Global Content

• Content for Software Developers

• Web Content

• Indexing and Attributing

• Tone and Rhetoric

• Accessible Content

• Common Style Problems

• Grammatical Elements

• Punctuation

• List of Acronyms and Abbreviations

Part 2: Usage Dictionary

6. Information Development

书名：Information Development: Managing Your Documentation Projects, Portfolio, and People

作者：JoAnn T. Hackos, PhD

出版社：Wiley Publishing, Inc.

Information Development 是 Technical Writing 的另一种说法。这本书从管理的角度出发，阐述了如何对文档项目进行管理。

其中涵盖了一些最佳实践，如 Best Practices in Information Development Management，Best Practices in Developing Effective Teams。如果你想了解文档的管理，可以看下此书。

内容概览：

• Part 1: The Framework

• Part 2: Portfolio Management

• Part 3: Project Management

7. Technical Translation

书名：Technical Translation: Usability Strategies for Translating Technical Documentation

作者：Jody Byrne

出版社：Springer

在实际工作中，Technical Communicator 经常需要将技术文档从一种语言翻译为另一种语言。

我在技术写作实例解析 | 若脱离理解，直译得再正确又有何意？这篇文章中结合实例分享了技术翻译中理解的重要性。如果你想系统地了解下技术翻译，推荐此书。

内容概览：

• Technical Translation

• Technical Communication

• Understanding Users

• Usability Engineering

• Assessing Usability

• Conclusions

8. Style: Lessons in Clarity and Grace

书名：Style: Lessons in Clarity and Grace

作者：Joseph M. Williams; Revised by Joseph Bizup

出版社：Pearson

这本书基于这样一种观点："it is good to write clearly, and anyone can do it." "Everything that can be said can be said clearly. —Ludwig Wittgenstein" 

写作一定要足够简洁清晰，不要一味堆砌貌似华丽的辞藻，搞得可读性很差，失去了写作的意义。简洁清晰即是美。要进行英语写作的小伙伴，这本书值得一看。

内容概览：

• Part One: Style as Choice

• Part Two: Clarity

• Part Three: Clarity of Form

• Part Four: Grace

• Part Five: Ethics

9. Technical Communication

书名：Technical Communication: A Reader-Centered Approach

作者：Paul V. Anderson

出版社：Wadsworth

这本书的书名就是技术传播，也是一本很系统的书。作为一个 Technical Communicator，这本书还是有必要读一下，有助于提升 writing 和 design 技能。

本书 Part 6 就是关于 Visual Elements 的，特别详细，包含很多条实用的 guideline，只 reader-centered graphics 就讲了 11 种。

内容概览：

• Part 1: Introduction

• Part 2: Defining Your Communication's Objectives

• Part 3: Planning

• Part 4: Conducting Research

• Part 5: Drafting Prose Elements

• Part 6: Drafting Visual Elements

• Part 7: Revising

• Part 8: Applications of the Reader-Centered Approach

• Part 9: Superstructures

10. Handbook of Technical Writing

书名：Handbook of Technical Writing

作者：Gerald J. Alred, Charles T. Brusaw, Walter E. Oliu

出版社：Bedford/St. Martin’s

这本书中有一句对 Technical Writing 的概括描述，很到位：

Successful writing on the job is not the product of inspiration, nor is it merely the spoken word converted to print; it is the result of knowing how to structure information using both text and design to achieve an intended purpose for a clearly defined audience.

书中讲到 Five Steps to Successful Writing：

• Preparation

• Research

• Organization

• Writing

• Revision

其中 Research 这部分的核心是："The only way to be sure that you can write about a complex subject is to thoroughly understand it." 

我在技术写作实例解析 | 若脱离理解，直译得再正确又有何意？这篇文章中的实例分享就是关于这一点。如果你想了解如何做 Technical Writing，此书建议一读。

内容概览：

• Technical Writing Documents and Elements

• Design and Visuals

• Correspondence

• Job Search and Application

• Presentations and Meetings

• Research and Documentation

• Organization, Writing, and Revision

• Digital Tips

• ESL Trouble Spots

• ESL Tips

• Style and Language

• Usage

• Sentences and Paragraphs

• Parts of Speech and Grammar

• Punctuation and Mechanics

好啦，这次分享的 10 本书到此为止，有问题请随意留言。书的海洋那么大，有空去看看吧！

你可能想读

若脱离理解，直译得再正确又有何意？

写在入职技术型创业公司 PingCAP 一个月之后

技术传播那些事儿

知乎专栏：https://zhuanlan.zhihu.com/tc-fun

简书专题：http://www.jianshu.com/c/c61708ae5bd1

点击“阅读原文”可直达我的简书博客阅读更多哦