我现在在尝试用 BBS 来做软件文档,大家先过来看看,然后扔点鸡蛋过来!!!

dsangvei 2004-01-28 12:35:41
用WIN2000 + IIS 作服务器,LOE XP论坛。

目前试用了半个月(1-15号),感觉什么东西都能放在上面,修改/查找起来很方便,还能加入各种图片说明,跳转链接。

首先,着手制作概要设计文档,这个可以比较简略,然后,就是详细文档了,与此同时,开始考虑编码。

这几天想得很多,在这上面瞎看了一通贴子,也找了一些书来看,特迷茫,我这半个月下来,每次打开BBS,就是千头万绪,不知从何说起,要做的太多,不知从哪里开始。没有办法,只有一点一点地来了。

现在刚开始详细设计,一个一个CLASS的写,每天一点点,效率特低,有时真想倒过来,先编写代码,然后再将文档补上去,但这样一来,文档是不可能完成的。我写了一年多的C程序,就只用TXT写过很简略的那种,写好之后,看都没有看。:(





...全文
56 12 打赏 收藏 举报
写回复
12 条回复
切换为时间正序
当前发帖距今超过3年,不再开放新的回复
发表回复
dsangvei 2004-01-30
BirdGu(鲲鹏) 说得没错。我现在也遇到了这个问题,导出是个问题,打包也是个问题,离线浏览用
IIS+LEO CGI 不能很好做到。
WIKI我没有用过,去找了一下相关地资料,不想改了。
  • 打赏
  • 举报
回复
ozzzzzz 2004-01-30
dsangvei(十年一剑)
我在这里讲的是在说文档和代码的存储和输出可以使用xml的方式。
对于xml的查询现在有XQuery体系,这是一种sql式的查询语言方式。而你使用什么样的工具来支持则没有规定。而在xml中一个最大的优势就是可以让dtd来规范你的内容,以至于可以对一些字段自动添加默认内容。而由于那些内容都规范的存储在不同的xml字段中,这就给我们提供了一个可以使用工具来处理他们的合适条件。
当然对于你现在的情况可能还达不到我说的地步,没有关系,慢慢来。
  • 打赏
  • 举报
回复
jug 2004-01-30
jive 是个不错的例子哟!
  • 打赏
  • 举报
回复
dsangvei 2004-01-30
谢谢版主,回复得这么快:)。
但我对XML一点都不了解,对此CGI倒知道一些。从现在使用的情况看来,并没有解决文档写作与查阅的问题,对于表单的处理我也不知道。现在正在找相关资料。想用MYSQL来做,将很多的LIST放在它上面,不知会不会好一点。
  • 打赏
  • 举报
回复
ozzzzzz 2004-01-30
我觉得充分利用xml是下一代SCM工具的核心功能。其实文档也好代码也罢,都是一种需要维护的资源。而这些资源中间最重要的是保持版本的同步,这些都可以利用xml来解决。而且xml还有一个好处是可以利用dtd来强迫它遵守某些约束,这无疑是一种非常有利的用途。而使用xml又可以使用xslt或者css来使其呈现多种不同的观感,这些有可以保持在不同的人员保持各自的习惯情况下在统一的环境下工作。
  • 打赏
  • 举报
回复
dsangvei 2004-01-30
这个倒没有考虑过。

ozzzzzz 有什么好的建议?
  • 打赏
  • 举报
回复
ozzzzzz 2004-01-30
大家是否考虑过输出xml文档,然后用xslt搞定的思路。
  • 打赏
  • 举报
回复
BirdGu 2004-01-29
用BBS还不如用Wiki。不过无论是BBS还是Wiki,文档的导出都会是个问题。对于向系统外部提供的文档,这个问题需要考虑。
  • 打赏
  • 举报
回复
dsangvei 2004-01-28
说实在的,现在开始做,很不得要领,看了一些贴子,一些对文档极其推崇,一些又不以为然。我所在的开发工作太杂,平时我都坚持写工作日记,但软件文档从来没有做过。现在开始尝试,试过用正规的方法,一周下来差点喷血。

我现在所在工作组才两个人,一个新手,我现在正带着他。他现在无法作一些较难的设计,只能我写出思路来,他才能够做得下去,用BBS的方法交换起来容易,可累死我了,写了两年的程序,感到语言功能已经退化,所以,写的时候真想直接写出程序来给他,但这样我一个人怎么能做两个的事?所以,我现在准备坚持半年,看看成效再说。
  • 打赏
  • 举报
回复
ozzzzzz 2004-01-28
wiki is good tool.
  • 打赏
  • 举报
回复
swinging 2004-01-28
rational的工具很不错,可是........sweat
  • 打赏
  • 举报
回复
stonespace 2004-01-28
有创意的想法,不过bbs有很多缺点。bbs的无法实现版本管理,一个信息经过修改后无法回溯,也无法放到原来的地方上。
  • 打赏
  • 举报
回复
发帖
研发管理

1247

社区成员

软件工程/管理 管理版
社区管理员
  • 研发管理社区
加入社区
帖子事件
创建了帖子
2004-01-28 12:35
社区公告
暂无公告