近期因为老师的书要出版,需要修改内容错误和语义表达方面的问题.然而有些表述上的问题我不太会再加上之前我就不太爱说话,所以就很菜.现在发觉,说话其实也是一门挺深的学问,所以就学习一下关于技术文档方面的写作.
英语世界里,文档非常受重视,许多公司和组织都有自己的文档规范,比如微软、MailChimp、Apple、Yahoo、docker、Struts等等(维基百科有完整的清单).相比之下,中文的也有,但是大都不太令人满意,要么你太简单,要么不太适用.
一位大佬简单整理的一份<中文技术文档的写作规范>
其中比较常见的一些:
1.如果使用了被动语态,就应该考虑更改为主动语态
错误:假如此软件尚未安装.
正确:假如尚未安装此软件.
2.不使用非正式的语言风格
错误：Lady Gaga 的演唱会真是酷毙了，从没看过这么给力的表演！！！
正确：无法参加本次活动，我深感遗憾。3.用对"的","地","得"(注意词义)
她露出了开心的笑容。
（形容词＋的＋名词）
她开心地笑了。
（副词＋地＋动词）
她笑得很开心。
（动词＋得＋副词）4.使用代词时(比如"其","该","此","这"等词),必须明确指代的内容,保证只有一个含义.
错误：从管理系统可以监视中继系统和受其直接控制的分配系统。
正确：从管理系统可以监视两个系统：中继系统和受中继系统直接控制的分配系统。5.名词前面不要有过多的形容词
错误：此设备的使用必须在接受过本公司举办的正式的设备培训的技师的指导下进行。
正确：此设备必须在技师的指导下使用，且指导技师必须接受过由本公司举办的正式设备培训。6.同样一个意思,尽量使用肯定句表达,不要使用否定句表达
错误：请确认没有接通装置的电源。
正确：请确认装置的电源已关闭。7.句子的长度尽量保持在20个字以内；20～29个字的句子，可以接受；39～39个字的句子，语义必须明确，才能接受；多于40个字的句子，在任何情况下都不能接受。
错误：本产品适用于从由一台服务器进行动作控制的单一节点结构到由多台服务器进行动作控制的并行处理程序结构等多种体系结构。
正确：本产品适用于多种体系结构。无论是由一台服务器（单一节点结构），还是由多台服务器（并行处理结构）进行动作控制，均可以使用本产品。8.尽量避免使用双重否定.
错误：没有删除权限的用户，不能删除此文件。
正确：用户必须拥有删除权限，才能删除此文件。原文地址:http://www.ruanyifeng.com/blog/2016/10/document_style_guide.html
