所有设备都需要指南和手册,以帮助人们有效使用产品。 用户手册具有自己的特定结构,应以清晰的方式编写。 开发文档是一个困难的过程,但是本文将有助于组织文档。
准备工作

假设您应该为设备开发用户手册。 首先,请考虑将要阅读您的用户手册的目标受众。 那么,如何与潜在用户进行交流呢? 您可以召集一个焦点小组,但首先,准备一个有关他们的年龄,教育程度,职业以及没有什么问题的列表(如有必要),此信息将在以后为您提供帮助。 然后要求他们测试设备的原型。 写下他们的反馈意见,不清楚的地方,面临的困难等等。 然后采访那些更了解设备的人,例如主题专家(SME),开发人员和程序员。
完成面试部分后,您可以走得更远。 下一步涉及阅读其他手册。 注意单词的选择,样式和结构。 大多数重要的和著名的公司,例如Google,Apple,Microsoft,都有自己有效的手册。 但是,如果它们不相关,则不应阅读它们,而应仅阅读与您的产品和范围相似的那些手册。
准备的最后一步是进行任务分析。 关键在于行动计划,这对于潜在用户及其以适当方式进行产品互动至关重要。 因此,您应该仔细考虑错误,错误和故障排除-产品思维就是产品解决方案。
写作过程

我在Facebook上与技术作家聊天,并意识到他们中的许多人都使用MS Word。 他们中的一些人甚至不了解专业工具,而其他人则违背其意愿使用MS Word,因为“有些公司尚未为21世纪做好准备。”如果您想使用帮助创作工具,但您不愿意知道您应该选择哪一个,以下是其中最受欢迎的列表。 但是,如果您的公司还没有准备好推出新产品,我建议您与团队负责人交谈,并介绍现代技术写作工具的所有优点。
让我们谈谈样式和词汇。 如您在阅读其他手册时可能会注意到的那样,技术作家会使用主动语态,这很有意义。 这种写作方式可以帮助读者更容易地理解信息。 另外,最好从命令开始每一步。 祈使动词通常用于响应序列,因此遵循所需的动作更加容易。
说到词汇,请使用您收集的有关目标受众的信息。 例如,如果潜在用户是成年人,并且他们没有对该产品进行相关的教育,则不要使用专门的词汇和技术语言。
如前所述,用户手册具有特定的结构。 它应该是合乎逻辑的,以便用户可以快速找到必要的信息。 为了创建易于理解的手册,请查看每个技术文档应包含的元素列表,并在编写时将其用作清单。
关于产品保养

因此,您需要为该设备开发一个用户手册,这就是为什么您应该包括一个部分来描述用户如何清洁它以及应该多久进行一次清洁的原因。 列举所有清洁步骤。 如果有必要删除某些部件,请确保详细说明此过程。 如果用户可以自己维修设备,请使用项目符号列表对其进行描述。
存储选项也很重要,如果对您来说很明显,那么用户可能会不清楚。 说明为什么必须以正确的方式存储设备以及用户应如何进行存储。 例如,“将产品存放在阴凉干燥的地方。”
另外,开发一个包含常见问题以及如何解决它们的部分。 为了简化搜索,对问题进行分组。 例如,如果显示信息有问题,请将其命名为“屏幕问题”。 此外,您还应该提供技术支持服务的电子邮件或电话号码。
准备好手册后…
准备好手册后,请您的朋友阅读并遵循产品使用的某些步骤。 这一步很重要,因为您的朋友不熟悉该产品,如果不清楚他们,他们将帮助您更好地描述它。
结论
因此,这些步骤将帮助您有效地开发和实施文档。 祝您技术上写好运!