1.清晰技术文件必须传达读者能够理解的单一含义。技术写作是昂贵的。他们在各个员工之间重要的沟通环节通常是报告,如果这个环节薄弱,整个项目可能会受到危害。不清楚的技术文字可能是危险的,例如不清楚的操作机器的说明。 2.精度不清晰的书写会导致很多问题,甚至在报告中不准确。如果你想写4万,就别写40万。如果你想参考图3.1,请不要参考图3.2。即使是最轻微的错误也会使阅读报告的读者感到困惑甚至恼怒。如果读者怀疑你在歪曲信息,他们有权怀疑整个文档。 3.全面性:当进行技术写作时,应该提供所有的信息,必须描述其背景,并明确描述任何过程,或开展具体工作的方法,也应该给出。它还包括结果、结论和建议。 4.可访问性:它意味着读者可以轻松地找到他们想要的信息。 要增加可访问性,请在报告中包含标题和列表。目录,插图,词汇表和索引是首选。 5.简洁:技术写作是有用的。文档越长,使用起来就越困难。甚至它会花费用户更多的时间。 简明不利于清晰和全面。解决这一冲突的方法是在清晰、简洁和全面的要求之间建立一个平衡。简而言之,在T.W中,对这一课题的每一个方面都进行了详细的讨论。文件必须足够长,足够清晰。它必须给观众目的和对象,但没有额外的细节。通过去掉不必要的短语,选择简短的单词和句子,技术文章可以缩短10-20%。 6.正确性撰写技术报告的能力还包括correctnes。好的技术报告也必须是正确的。它。必须没有语法错误,标点错误,并应有适当的格式标准。如果报告中有语法错误,读者会怀疑报告中信息的准确性。技术性写作的目的是传达信息和说服听众。为了实现这些目标,它必须是清晰的,容易获得的,必须是经济的和正确的。 如果你想写"the three person: person 1, person 2 and person 3 attended a session",但你用逗号代替冒号,你的读者可能会认为是6人出席了会议,而不是3人。 |