公民指出标志 AboutCivil标志技术报告要点,技术报告质量

技术写作的特点

广告

技术写作是每个人职业生涯的重要组成部分。写好是一件困难的事,需要花费大量的时间,而用一种技术的方式来写技术主题甚至会让写作变得更加困难。人们写作的目的是提出项目,记录自己的行动,帮助他人理解研究,分析和解决问题,描述程序和对象。如果做得好,技术写作是一种令人兴奋、令人满意的经历,但如果做得不好,它就令人沮丧,甚至对职业发展有害。书面的技术性是基于以下几点

有六种基本的技术写作的素质特点技术写作的特点

  1. 清晰
  2. 精度
  3. 全面性
  4. 可访问性
  5. 简洁
  6. 正确性

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人。

SJ标志 关于我们|站点地图|隐私政策|联系我们|©2014 WebTechTix