在正式开始阅读之前，我必须通知我亲爱的读者和朋友，这篇文章是我工作以来使用工具的经验和体会的总结。这并不意味着这就是交互式文档的写作范式。交互式文档可以根据我的公司和团队的需要编写。我将只在这里分享我的经验。< br>Axure和蓝色泻湖是我日常工作中最常用的两个软件。一个是设计生产力工具，另一个是在线协作工具。他们一起工作并不累。
本文分为两部分。第一部分是分享我个人如何在工作中使用Axure创建交互式文档。第二部分是如何使用蓝色泻湖与产品经理、视觉设计师、客户和其他人(如运营人员)合作。本文基于个人有限的工作经验和知识积累。如果有什么缺点，请原谅。如果有任何错误，请指出来，相互学习和交流，并感谢您的阅读。一、区分产品需求的层次。当为一些更新的和官方的产品写文档时，你应该知道需求是一个完整的项目还是对现有项目的完善和优化。如果是一个新项目，你需要在文档中描述产品介绍，用短句描述产品功能和目标用户。但是，如果是更新和优化，您只需要描述项目名称和更新的功能摘要。2.交互式文档1的元素。文档描述(版本描述，使用的平台)文档描述等同于文档的封面。文档描述应简要介绍文档中涉及的产品、平台、版本和参与者。
2。更新日志
更新日志是文档的重要组成部分。更新日志包含从第一个版本到最后一个版本直到开发启动的项目摘要。我和其他协作人员可以方便地快速找到文档中优化部分的添加、删除或优化时间。我自己创建的更新日志页面包含以下基本元素:时间:时间是指优化后文档上传到协作平台(如蓝礁湖)的时间，可以指定文档更改的具体时间。更新内容:更新内容是指将文档变更的功能点逐一列出，并用文字描述。更新内容是更新日志中非常重要的一部分。如果没有文字描述，在审阅文档版本时就不可能快速检查和浏览文档版本。这对以后的维护将是一场灾难。更新页面:更新页面是指不同交互页面对应的更新内容，有助于开发人员或其他小伙伴快速准确地找到更新的内容。开发人员没有时间一个接一个地浏览大量文档，所以版本更新只需要告诉他们在哪里进行了更改。更新类型:有三种更新类型:添加/删除/优化我用不同的标签标记每个版本更新，这可以更直观地解释当前版本更新类型是新的还是优化的此外，可以根据自己的要求添加修改量、版本号和其他元素。因为在实际的项目中，我是唯一一个维护文档的人，而SaaS版本的规划不是很清楚，这两点没有涉及到我的文档中3.预读笔记
预读笔记是指文档用户在阅读前应该浏览的笔记，否则他们无法理解文档中的某些特殊符号阅读前注意事项我可以分为以下两种类型:(1)一般识别描述一般识别描述是指对整个文档中广泛存在的识别元素的描述，以帮助读者快速理解文档的特殊识别和术语
(2)通用部件描述通用部件描述是指开发新产品时建立的一套简化设计规范。设计规范指定了当前文档中某些组件的样式、交互和特殊情况。4.结构图、流程图和思维导图(1)一般来说，当所有的文档都被更新和上传时，我会使用Axure的生成流程图功能为所有的页面生成一个树状结构图。点击结构图中的模块可以轻松跳转到相应的页面。这样，开发人员在查看文档时就可以直接打开文档结构页面，而不必逐个浏览文档。整个文件的结构一目了然。点击该模块可以直接跳转到相应的页面，方便快捷。
(2)流程图流程图是指与业务相关的流程图。业务逻辑由流程图描述。通常，这种排序逻辑只用于复杂的业务。该流程图不仅有利于构建完善的业务流程，也有利于排序业务逻辑的发展。
(3)思维导图思维导图根据文档的需要以思维导图的形式列出产品的功能。开发可以耗尽每个类别下的子级别，从而获得一个完整的结构。
以上三个是帮助文档用户和作者理解文档的图表。因此，它们不是必需的。可以根据业务需求绘制相关的图表。Axure本身并不支持流程图和思维导图。因此，您只需要在第三方软件完成后将图表复制到Axure界面。5.交互页面交互页面是整个文档最重要的部分，也是整个文档的主体。每个行业中每个产品的交互文档都是不同的。“形而上学家称之为”虽然他们不同，但他们也可以总结一些共同的规范:(1)文档结构应该清晰合理。交互式文档的层次划分应该清晰明确。页面的划分应该通过产品的结构来进行，以区分页面的主要和次要，
(2)所使用的词语应该准确和明确。首先，在描述文档时，词语必须准确无误。如果专业术语解释不清楚，你可以稍后举一个例子。您的文档的目的是让读者理解它，无论它是开发还是产品。因此，用通用语言描述你的文档，并在适当的时候给出一个例子来补充。其次，与您的文档相对应的产品的目标用户能够理解您的描述也很重要。例如，在后台产品中，用户不一定是知识水平很高的人。如果你在没有解释的情况下使用专业术语，如“门槛”，用户很难理解产品的功能。
(3)流程完美无缺。一般来说，交互式文档在交付时总是因为各种原因而丢失，或者是因为不熟悉的业务而没有涉及到一些功能，或者是因为对技术的无知而丢失了一些特殊的场景。此时，我们需要通过交互式的浏览和回顾来发现相关的问题。浏览是让作者对照浏览表来整理页面中的空白，而评论是从他人的角度来发现问题。因此，一个好的过程是不断迭代和完善的。您需要做的是尽可能使交互式文档完美无缺。
(4)文档模拟数据尽可能多地恢复真实数据许多人在设计时填写大量模拟数据以支持页面内容。sketch有许多自动填充的插件，如头像、图片、文本、姓名甚至地址等。这种插件方便了我们的工作，但有时文本的填充不适合我们的业务，甚至可能完全不相关。然而，Axure没有这样的插件，所以在设计时，我们尽最大努力还原真实的场景，比如商品名称，写真实的商品名称和地址，写真实的地址。如果你填写不合逻辑的文本，读者很难主观地融入产品的使用场景
当然，用不同的真实文本填充每一条数据将会花费我们很多时间。你也可以采用一些更聪明的方法，例如，一个列表，第一行使用真实的文本，其余的复制第一行。然而，如果涉及不同的状态，有必要加以区分和解释。(5)限制大小写和缺省状态应该注意许多初学者，他们可能经常被问到，“你能在这个文本框中填写多少个字符？”，这是由于文件和问题中没有解释极限值，除了指定“最大”情况外，还需要指定“最小”情况
然后问题出现了，我们应该如何判断用户应该输入的字符范围？首先，这是由两个因素决定的第一个因素是在一般业务场景下，输入字段中通常使用多少个字符，例如商品名称。我们可以检查淘宝和其他平台的商品名称，并结合我们的业务限制该领域。第二个因素，即输入的字段，是您的业务场景中显示的区域，以及该区域中允许显示的字符如果在您的前景列表页面中只为该字段保留了一行，那么您应该直观地判断要显示的大约字符数。如果只显示一行，那么您应该设置截断规则，它通常被“…”替换，以便在单击详细信息页面时显示所有字符。有太多类似的极限情况，如网络断开、过程中断、数量范围等。，并且根据业务和场景的不同，极限情况也有所不同，因此这里我们不一一列举。需要注意的另一件事是默认状态，即默认状态在设计界面时，我们设计的是一个包含全部内容的页面，而不是产品的初始状态。如果我们设计初始状态，我们的设计草案将是空白的。因此，当我们完成产品设计时，我们还需要整理页面的默认状态，例如个人中心没有订单的情况，后台商品列表中没有商品的情况，以及查询为空的情况。(6)文件注释需要清晰明确。除了交互式页面的设计，最重要的是注释。除了可视化界面显示外，操作交互的很大一部分是通过注释来解释的。在我的工作流中，我将其分为四种类型:全局描述、带标记线的描述、局部描述和交互描述，分别是对整个页面的描述、带视觉引导的描述、带局部功能的提示性描述和操作描述它能很好地使开发人员快速、准确地定位和理解注释内容
(7)从第三个角度看文档，将自己视为文档的用户、产品的用户和文档的审阅者。从这个角度来看，你会明白这些地方的语言不清楚，逻辑也有些混乱。当详尽地整理页面时，不要偷懒，解释你能想到的一切。
6。文档附件交互文档的意义是用可视线框向相关人员展示产品需求，因此需要辅助文档来提高整个文档的功能。这些文档附件包括但不限于导出字段表、上传表、产品需求表以及用其他软件制作的辅助文档等。它们通常保存在电子表格、Word文档、PDF文档和其他文件中。由于axure不具备直接上传其他文件类型(图片和文本除外)的功能，我们通常使用云协作软件来上传，比如blue lagoon的资源库功能通常，您需要在文档所需的页面上添加相关说明，以表明相关文档附件的存在。
7。回收站功能回收站是指由于需求变化或其他原因而不需要的组件和页面。您需要优化或删除整个，但它不会被排除。您只需将组件或页面放入回收站，并标记相应的名称(以便于下一次查询)。如果以后需要，可以直接复制到相应的页面。8.交互式上行表构建交互式上行表首先需要熟悉产品业务逻辑。走查表是建立在产品功能上的，每个产品的交互式走查表是不同的。其中，平台差异相对较大。例如，移动应用和web平台之间的差异导致了不一致的页面实现逻辑，因此容易遗漏的点是不一致的。网络端基于浏览器实现逻辑，而应用程序需要根据每个平台(iOS和Android)的不同构建不同的升级表。然而，这仅仅是平台规范的一次升级，主要业务逻辑的升级是不一致的。基本逻辑演练:
业务逻辑演练:
构建演练表是一个持续改进和迭代的过程。只要你不松懈，你通常会建立一个很好的规避措施。第三，其他问题:1。在开始一个项目之前，如果它是一个全新的项目，我建议你为这个项目创建一个组件库。也许这将花费你很多时间，但是你会在随后的设计中感觉到它的方便。与此同时，在您建立了一个标准化的组件库之后，您不需要不时地检查诸如大小和大小之类的详细规范。您只需要将它拖到界面上的适当位置并进行更改。这不仅可以保持整个文档的统一性，还可以提高设计文档的效率此外，如果您的产品有自己的设计系统，但它不是制成组件，我建议您仍然制作一套组件，并将其引入您的Axure，这将为您的后续更新和维护带来极大的方便。同时，您也可以使用第三方设计组件，如蚂蚁金推出的蚂蚁设计。2.我应该选择哪一个，高保真还是低微？一些有视觉背景的交互设计者可能会纠结于交互文档是否应该像设计草稿一样添加很多交互和动态效果。在高保真和低保真度之间进行选择的唯一依据是您的交互式文档使用场景是什么，以及谁是目标用户。如果您的使用场景是在公司内部开发和使用的，并且目标用户是与您合作的前端和后端开发人员、产品和用户界面，那么您的文档存在就是为了提高开发效率。此时，您不需要制作与视觉草图相同的东西。你只需要用黑白和灰色线框制作产品的原型。这样做的好处有四个:(1)设计效率极高，可以快速完成产品的原型设计；(2)修改方便。在原型阶段，交互草稿被频繁地改变，所以如果你像视觉草稿一样做并且添加许多交互操作，这些改变将几乎杀死设计者。(3)无细节快速检查适合开发。当页面有许多用户界面元素时，它会影响开发(后端)梳理逻辑，因为这些细节会误导他。此外，用户界面的元素是可变的和不确定的。在开发之初，只需要梳理业务逻辑。至于用户界面，这是一个视觉设计草案和前端的问题，在互动阶段没有这样的问题。(4)用户界面可以充分发挥其设计感，设计出更精彩的界面作为交互设计者，我们只需要关注页面和业务逻辑的交互，而不是元素圆角和阴影的大小。如果你的交互草稿和用户界面的视觉草稿一样，会主观地影响用户界面设计者的判断，甚至会引起同事之间的冲突。如果你的使用场景是一个项目演示，目标用户是老板、甲方(客户)和没有相关软件开发知识的测试用户，你需要根据自己的需要建立一套可点击、可跳转的高保真原型演示，在项目演示过程中给客户或老板一个直观、生动的印象。如果他们拥有大多数的决策权，他们将有很大的机会通过这个计划。因此，没有必要争论高保真和最低保证。应该选择哪一个来查看交互原型的使用场景和目标用户就我个人而言，我不建议在一般工作场景中将交互式文档制作成可视草稿。1.Axure上传到蓝泻湖，建立文件，在蓝泻湖建立相应的项目，吸引相关参与者，Axure文件通过蓝泻湖软件直接上传到蓝泻湖平台，通过其他通讯软件通知参与者文件已经上传。
2。将附件文档上载到资源库。如果您的交互式文档有其他类型的附加文档，您可以将它们上载到资源库，并在交互式文档的相关页面上进行解释。
3。当查看版本历史功能时，开发者可以点击相关的版本历史进行比较和查看，也可以快速跳转到有文档变化的页面。
4。交互式文档关联设计草案如果您的设计草案和交互式文档的页面使用相同的名称，blue lagoon会自动将您的设计草案与交互式草案关联起来，并可以直接从交互式草案跳转到相应的设计草案，这对于前端开发非常方便。然而，目前没有手动相关功能。在大多数情况下，自动关联不是很有用。只能说它是一种鸡肋功能，无足轻重。我希望可以执行后续的手动关联。
5。团队成员协作、标记并通知，如果某个功能需要特别强调，可以直接向原型和@参与者添加注释。blue lagoon的注释功能已经非常有用，但是唯一的缺点是如果有变化，我不能同时在一个软件中修改页面和注释。因此，如果在Axure中修改页面，然后在蓝色泻湖中修改注释，对我来说效率太低了。因此，我的注释是在当前页面上进行的，这便于导出和在线协作。
6。共享带链接密码的文件原型如果您的项目需要向第三方展示，但他不想注册蓝礁湖的帐户，如甲方、客户、参与测试的用户等。，您可以将链接和密码发送给相关人员，方便快捷。
本文到此结束。当然，交互式文档不仅包含这些内容，而且根据不同的需求和业务场景有不同的范例。因此，通过总结适合自己和团队的交互文档来进行协作是最好的方式。在我看来，尽管交互式文档在标准化方面面临挑战，即如何输出他人容易理解的文档，但最重要的是如何根据业务需求输出合理的解决方案，以实现业务需求和技术实现之间的平衡。让我们举一个简单的例子来说明技术交流的重要性:在做一个与表单相关的项目之前，当表单是在后台创建的时候，表单域的排序是涉及到的。我设计的方案是填写表单名称和表单简介以及字段，然后用最后一个键提交。有一个问题，前端与我沟通，因为我们的系统中没有这样的交互，有必要在保存到数据库后上下移动表单。如果你想在前端进行虚假的上下移动，并将最后一个密钥提交给数据库，这将是非常耗时和费力的。因此，我们对方案进行了优化，并逐步实施。首先，在创建新表单时，我们填写了表单名称、表单介绍和相应的限制方法。保存后，我们在下一步表单中添加了字段。添加每个字段后，我们直接将它保存到数据库中，并上下移动以与数据库交互。最后，我们为用户提供了一个保存按钮和一个保存和发布按钮。用户可以在前端独立选择表单的显示状态。此外，在第二次编辑时，我们把它放在同一个页面上并垂直放置，因为此时，系统和将表单写入数据库与我们之前的交互是一致的。有许多类似的例子。它往往存在于发展和交流的过程中。我也认为理解技术的交互设计者在计划的实施中有优势。然而，这种对技术的理解并不意味着你必须写代码。相反，你需要了解计算机是如何实现你的设计计划的。这是另一个冗长而复杂的话题，所以不会在这里展开。
-/好课选择/ -但是这些很难通过自学来实现< br>
在此，我向您推荐由起点学院和腾讯班联合开设的产品介绍课程“90天产品经理实践培训课”,它将带您系统地学习产品知识的核心模块，从0到1实践产品的全过程，掌握标准文档的输出能力，满足产品岗位聘用的要求！< br>
专业教学助理将逐一诊断您的产品介绍问题。注册后，他们将发送Axure基本操作课程，并为您挑选干货材料，以供您收集~
手机网站
