日期:2014-05-17  浏览次数:20772 次

请教一个问题:写开发说明文档用什么工具
目的:在一个文档中,表现出组织结构图,模块图,用到的数据以及常用的操作。
例如:首页
  模块分为:公告、文章列表
  用到的数据:公告(公告Id,公告内容);文章列表(文章Id,文章标题,发表时间)
  操作:点击文章列表中某项跳转到文章阅读页面(这点可以文字描述就行)。
目前实现方法及缺陷:
  1.使用Word,太过繁琐,并且阅读者不容易理解。
  2.使用visio,效果不错,但是当你建立的是数据库实体模型时,你就不能使用流程图模型。这点比较郁闷,如果能够让多个模型混在一个文档中,那么visio就是不错的解决方案。
  3.使用UML图,太专业,不容易沟通。并且我也不熟悉,不知道能不能表现我想要的。


  目前情况是,原型图已经画出来了。想根据每个页面整理出:
  1、该页面的模块关系;
  2、该页面用到的数据结构;
  3.该页面用到的事件;
  4、该页面模块或者功能点的描述(类似注释)

  我所在公司是个小公司,不适用于正规的开发流程。所以想规范一下开发步骤。我的思路是:首先建立原型;然后写出需求者和开发者都能看得懂的开发文档;下一步画出UML图,只画类的就可以;最后才是正式开发。
  不知道各位大神有什么意见或者好的工具,可以分享出来!

------解决方案--------------------
--Rational Rose 一种面向对象的统一建模语言的可视化建模工具

--Microsoft Office Visio 2007 是微软公司出品的一款的软件,它有助于 IT 和商务专业人员轻松地可视化、分析和交流复杂信息。它能够将难以理解的复杂文本和表格转换为一目了然的 Visio 图表。
------解决方案--------------------
探讨
例如:首页
模块分为:公告、文章列表
用到的数据:公告(公告Id,公告内容);文章列表(文章Id,文章标题,发表时间)
操作:点击文章列表中某项跳转到文章阅读页面(这点可以文字描述就行)。
目前实现方法及缺陷:

------解决方案--------------------
探讨
目前实现方法及缺陷:
1.使用Word,太过繁琐,并且阅读者不容易理解。
2.使用visio,效果不错,但是当你建立的是数据库实体模型时,你就不能使用流程图模型。这点比较郁闷,如果能够让多个模型混在一个文档中,那么visio就是不错的解决方案。
3.使用UML图,太专业,不容易沟通。并且我也不熟悉,不知道能不能表现我想要的。

------解决方案--------------------
探讨
我的思路是:首先建立原型;然后写出需求者和开发者都能看得懂的开发文档;下一步画出UML图,只画类的就可以;最后才是正式开发。

------解决方案--------------------
确实唉,到底用什么