请点击这里以获得帮助 David McMurrey 支付网页托管费用:
捐赠你能做到的任何小金额!
Online Technical Writing akan kekal percuma.
当你写指示、程序和“指南”或用户指南信息时,通常必须采用任务方法。这意味着提供所有用户可能需要执行的重大任务分析的步骤和解释。
当然,有些指示只涉及一个任务—例如,换车油。但我们在这里关注的是更复杂的程序。虽然本章以计算机软件作为例子,但这些技术可以应用于任何多任务程序—例如,操作微波炉。
识别任务
要以任务导向的方式写作,首先要进行一些任务分析。这意味着研究用户如何使用产品或完成任务,采访他们并观察他们。这也可以包括采访市场和产品开发人员。如果你能获取到客服人员收到的相关问题,这也会有帮助。
But sometimes, you might not be able to do a detailed task analysis. Usually, product developers don’t consider documentation until quite late. In these situations, it can be tough to get the marketing, development, engineering, and programming teams to spend enough time with you to explain the product thoroughly. So, you end up making some educated guesses. The developer is more likely to check your draft and inform you if your guesses are correct.
要开发自己的任务分析,你可以研究产品的用户界面(按钮、菜单、选项等)。这适用于硬件和软件。考虑一下下面显示的图标编辑工具的界面。从这个界面的片段中,你可以识别出几个明显的任务分析:新建、打开、另存为、退出:
AZ Ikon Edit Antaramuka |
Now, check out the menu options for the next parts of the menu. You can see that when people are using this icon editor, they’ll also likely be doing these tasks_analysis:
|
But now look at the interface without the menu options hanging down. You can see what additional task_analysis? Just like many graphical user interfaces, some of the icons repeat the menu options. For example, the bulleted-list icon lets you choose a thin, medium, or thick line just like clicking on Pilihan 有。不过,这里有一些新的工具,是在界面其他地方无法找到的:
|
你对这个软件还有很多不清楚的地方,但你已经做了很多猜测来定义主要的任务分析。你可能想要将这些东西更紧密地分组和整合,比如如下:
- 创建、编辑、重命名和保存图标
- 选择前景色和背景色
- 画线、长方形和椭圆
- 剪切、粘贴和复制对象
- 移动、翻转和旋转物体
你可以看到在这个粗略的任务列表中,没有任务分析的痕迹,比如填充颜色、捕捉图像、清理工作区、撤销错误或恢复。但是在你工作时,这些细节会开始在你的方案中找到它们的位置。现在,退一步看界面的细节,把自己放在一个图标软件用户的角度。那个用户可能会问什么问题?我怎么改变背景的颜色?这我们已经考虑到了。怎么改变我画的线条的粗细?这点也已经解决。怎么让背景变得透明?嗯……这将是颜色部分的问题,但这需要一些研究。
不同的文档编写方法
When you write for users, you can choose between two approaches, fungsi orientasi and 任务导向,后者无疑是更好的选择。
以功能为导向的写作。 它应该很明显在任务分析后该如何进行,但显然不是。计算机出版物—如果不是技术出版物一般—常常似乎偏离了以任务为导向的写作风格。但,不!这根本行不通!
另一个用户指南说明不以任务为导向的原因可以归咎于产品规格。产品规格是由程序员、工程师、开发者编写的,它们是从所需功能的角度来写的:
| Fail menu butang | 让用户创建新文件、打开现有文件、重命名文件等。 |
| 裁剪图标 | 使用户能够剪切所选的图像片段。 |
你可以称这种方法为 功能导向 写作是因为它系统性地解释了产品的每个功能、特性或接口元素。不幸的是,这种方法出现在针对非技术读者的用户指南中—可能是因为作者没有经验、缺乏培训或不懂技术;或者作者也许是在开发者规格书完成得太晚时被叫进来的,只能做一些润色。
功能导向的方法有时几乎有效。但“几乎”和“有时”都不够好。它之所以几乎有效,是因为界面元素和函数的名称有时与它们支持的任务分析相匹配。例如, 开放 菜单选项很直观:打开一个现有文件。其他的就没有那么直观了。例如,你认为“恢复”是什么呢? 恢复 AZ Icon Edit 界面里的按钮?另外,一些界面元素并不能独立完成任务。在 Photoshop 里,例如,你不能仅通过按下按钮来裁剪文本。 修剪 菜单选项。您首先需要点击文本选择按钮,然后在您想要保留的图像部分周围绘制一个选择框,接着按下 收割 button.
以任务为导向进行写作。取代以功能为导向的方法,使用以任务为导向的方法。确定用户使用产品时需要执行的任务分析,然后相应地构建文档。设置你的标题和子标题。 任务导向 dalam penyusunan mereka. Frasa berorientasi tugas bermaksud penyusunan seperti "Cara untuk melaraskan kelantangan," "Melaraskan kelantangan," atau "Laraskan kelantangan." Ia tidak bermaksud penyusunan seperti "Kelantangan" atau "Pelarasan Kelantangan." Berikut adalah beberapa contoh tambahan:
| Masalah pernyataan | 任务导向的措辞 |
| Capture | 捕捉图像 |
| 屏幕按钮 | 选择背景或前景物体 |
| 长方形 | 画矩形 |
| 椭圆图标 | 画椭圆和圆形 |
当你定义了用户任务分析,将它们组织成逻辑组,并且定义了以任务为导向的标题后,便可以开始写作了!以下是一个摘录:
|
画矩形和椭圆 你可以用图标编辑器画方形、矩形、椭圆和圆。 画一个长方形。 要画一个矩形:
|
In this excerpt, you can see that the overall approach is task-oriented and that task-oriented phrasing is used for the headings.绘画). 也注意到编号列表被用来一步步引导读者完成任务中的各个动作。
相关信息
任务导向写作. WTD
I would love to hear your thoughts, reactions, and criticism about this chapter: Sorry, I need the text you want me to translate. Please provide it..
