有人问我你究竟是哪里好，没见过LiveDoc的人不会明了

                     

 

   谨以此文献给那些正奋战在一线的产品经理、需求工程师或BA们，希望能帮助这些小伙伴们在繁重的文档工作中解放出来。

 

今天要介绍的主角是Polarion的专有技术：LiveDoc。

LiveDoc可直译为“活文档”，这里隐含着Polarion对于需求管理的理念，也就是说，不管产品经过了几轮迭代，文档和产品始终应该是一致的。这其实是一个蛮大的挑战，我们经常会看到开发人员说‘那份需求文档仅供参考，最好还是看源代码’，然后开发又重新回到代码考古模式…

 

了解UML的朋友应该会知道，当年曾经在市场上叱咤风云的Together工具中有一个技术叫LiveSource技术，实现的就是源代码和UML模型的双向同步，而当年的TogetherSoft公司的技术团队实际上就构成了Polarion的早期研发团队，所以您会看到在Polarion中，有诸如：

LiveDoc、LivePlan、LiveReport这样的技术，背后的理念都是一脉相承的。

 

那么，到底LiveDoc能带来什么好处？先讲一个真实的故事，2015年底，本人参加一年一度的上海敏捷之旅，会上一个来自国际一流企业的朋友提问说：他们经过了多轮敏捷迭代后，所用研发系统中已经积累了将近1万个用户故事，现在的困扰是难以理清这些用户故事之间的关系，因为这些用户故事之间可能会有前后修改、补充、或部分重叠等各种关系，很容易出现只见树木不见森林的情形。而LiveDoc这种文档形式，就可以帮助我们以结构化的方式，在上下文场景下来阅读它们。

 

 

 

➤LiveDoc将Word的用户体验带入到需求管理领域，这对从事需求管理工作的朋友来说，无疑是极大的利好。LiveDoc中有多级标题，形成了文档的骨架，同样也提供了大纲结构，可以帮助我们在大型文档中快速导航。LiveDoc的编辑方式与Word高度相似，每次编辑都会生成一个新的版本，帮助我们跟踪历史信息，实现可审计性。与Word相比，一个显著的变化是，这里的需求都实现了条目化管理，我们说条目化是做好需求管理的必由之路，敏捷对于用户故事同样也强调INVEST原则，以实现需求的良好颗粒度。LiveDoc是用户故事的极佳承载工具，通过文档大纲，我们能做到在整个文档中自由切换；通过标题和用户故事之间起到“串联”作用的正文，可以帮助我们极为流畅的在上下文下阅读和理解用户故事，极佳地解决了前面所说的“只见树木，不见森林”这样的问题。我们可以在LiveDoc中跟踪用户故事的价值交付流，当然，也可以在Polarion中提供的精益看板上来呈现。

 

➤LiveDoc对于需求的刻画能力是很强的，您可以在文档中插入图片、表格、项目符号；修改文字的颜色、字体、字号等等，甚至您可以在文档中进行在线绘图，来绘制业务流程图、UML图、用户界面原型等等。您甚至还能LiveDoc进行编码，以插入一些动态内容。我们曾经就有客户直接通过LiveDoc，以所见即所得方式生成所需要的月报、季报这些报表，极大地减轻了例行工作量。

 

图：在线绘图

 

➤LiveDoc提供了多种视图，用户可以自由地在这多种视图之间进行切换。例如切换到表格视图，浏览文档中包含的需求项；切换到矩阵视图，查看需求跟踪矩阵等等。无论哪种视图，数据都是同一份，只是看问题的视角不同而已。

图：切换到需求规划视图，满足迭代规划需要

 

➤LiveDoc提供了强大的需求评审能力，独有的需求评审中心将评审对象、评审进度以及评审结果在一个用户界面中集中高效地呈现在我们面前：

图：需求评审中心

 

➤LiveDoc自身具有流程配置能力，用户可以根据需要，来配置自己的文档流程，记录文档从草稿，到评审，到发布的完整流程。并且，这一流程可以和LiveDoc中包含的需求项的流程可以产生勾稽关系，例如，我们可以控制，当LiveDoc中包含的需求项还有没有审批通过时，我们不能发布LiveDoc；当需求评审时有评审意见没有被关闭时，也不能发布LiveDoc等等。LiveDoc的审签流程支持电子签名。

图：文档流程的例子

 

➤LiveDoc具有双向协同功能，双向协同不等于导出和导入，而是导出后、离线修改、再将外部修改的变更导入回来。LiveDoc在外部修改时无须安装任何插件。LiveDoc的双向协同既支持Word/Excel，也支持ReqIF格式。

 

➤LiveDoc提供了文档分支与合并功能，这一功能对于产品线研发模式特别适用。因为对于同一产品线下的多款产品来说，需求大部分是相同的，通过少量需求的调整，就能转变为针对另一款产品的需求规格说明。传统通过手工拷贝的方式，效率低下，无法确保需求拷贝后再次发生变更时的一致性。LiveDoc提供的文档分支与合并功能，极为优雅地解决了这一挑战。进一步，Polarion基于LiveDoc技术，还提供了在需求管理工具中独有的变体管理功能，帮助我们基于特征建模来形成产品线的特征模型，进而可自动生成针对产品线下某个产品（变体）的需求规格，以及后续的测试用例等等，特别适用于汽车、医疗设备、国防等这种研发特点的企业。

 

作为一项技术，LiveDoc不仅适用于需求管理，也可以用来管理测试用例、风险、设计等等，我们甚至还使用LiveDoc来管理会议纪要，通过会议纪要自动生成“行动项”，自动为参会人员记录工时等等。