[原创] 粗看日本软件设计文档软件测试基地论坛 - 软件测试 | 软件测试资料 | 软件测试管理 | 自动化测试


» 您尚未登录注册 \| 社区服务 \| FTP中心 \| 帮助 \| 社区 \| 无图版 \| 测试百科 \| 测试Blog

软件测试基地论坛 -> 测试用例设计 -> [原创] 粗看日本软件设计文档

XML

RSS 2.0

WAP

--> 本页主题: [原创] 粗看日本软件设计文档

加为IE收藏 | 收藏主题 | 上一主题 | 下一主题

Fastpoint

级别: 总版主
精华: 44
发帖: 5033
基地声望: 390 点
基地币: 1674 Bug
基地贡献: 0 点
好评度: 15 点
在线时间:818(小时)
注册时间:2005-10-08
最后登录:2008-07-22

[原创] 粗看日本软件设计文档作者：Fastpoint 转载注明链接：http://www.cntesting.com/bbs/read.php?tid=1838&page=1&toread=1 今天有幸拿到一份同行兄弟给我的对日外包软件设计文档，很平常的Excel文档，打开一看内容却感到非常不一般，以前听说过日本IT企业的“认真地死板”，今天算是感受到了。这份文档分8个sheet，每个sheet明确针对不同描述领域，分别为：链接、版本修正、软件架构和业务物理模型、界面原型、界面原形元素设定（包含初始化）、界面原形元素数据实现顺序、动作实现顺序、底层数据集描述和实现。怎么说呢？我算是看到过很多设计文档的人了，国内的、欧美的，这次加上日本的算是全了70%了，我不想对日本发什么感慨，我只是想从这份文档本身出发谈谈看法。 1. 为什么要有独立的链接页面？其实这个问题我不用多说，但凡是在IT行业做过的都知道这个行业有个很大的特色：早先没什么文档，自从CMM能增加企业光亮开始，文档一夜之间就铺天盖地的出来了，甚至有段时间国内出现了文档容量攀比态度，各个公司之间，每个IT从业人员之间相互比对谁拥有的文档多，多意味着什么？专业啊！问题是文档多了管理这些文档也麻烦了，不是丢了就是被某些糊涂蛋删除了，幸好聪明的国人想到了配置管理，我把这些文档分分类放到配置管理库那么就一切OK了。我曾经入职过一家国内的大公司，第一天上班“师傅”就带给我一个10G的资料让我“学习”，我对这些文档的第一个印象就是支离破碎，看完这个刚有点感觉想看下面的时候，找不到后面的资料了，当我找到后面资料时思想全乱了，一天下来头昏脑涨，这也是我看到的最讲究逻辑的行业做的最糟糕逻辑的事情了！所以文档有个链接就非常好了，你可以让每个孤立的文档连成一个整体，让阅读者的思维通畅起来。回过头我重新看了一下RUP2000，里面的文档也是非常讲究相互链接的，不知道为什么这么好的东西到了中国就“消失”了。 2. 版本修正我觉得国内只要是想正儿八经做IT的都会在各自的文档上加这个，只不过很多人没有考虑一个阅读的科学性，我以前的文档全是在目录后跟版本修正，这样的话如果一份文档变动非常频繁，那么会造成页面下拉厉害影响视觉。有个细节是，这份日本设计文档的版本修订区是根据每个sheet做修订大项的，每个sheet的细节分类变更包含其中，这样可以跟踪得很细。我们原来的文档着这方面却可以看出，细心的人写的细，粗心的人写的粗，总之在标准的文档也会有不标准的地方。 3. 软件架构和业务物理模型国内也有，至少我以前接触的文档就有这方面的内容，不过大多数是根据欧美风格来的，大框架的描述的非常精美，如果你想看细节架构和数据流就没了。这份日文设计单独开辟了一个sheet专门描述着描述这件事情，选用的图形比较中规中矩，看了以后至少知道什么是入口，中间经过何等处理，最后的输出是什么或者什么形式。看来日本并没有大规模推广UML语言，他们就是用了office提供的图形，我现在有些搞不清楚了，国内很多企业标榜自己的设计完全UML化，出来的文档很专业，结果是少数人看的懂，也许在某些国人眼里，设计就是那天上的月亮岂能让凡夫俗子把玩乎？！文档的细节是将模型中出现的文字都一一作了解释，有点词汇表的意思，但是没有RUP中词汇表那么大的作用范围。 4. 界面原型原型这东西最能让阅读者快速理解，2000年开始国内很多IT企业就讲究快速原型开发方法，但是至今我没看到过一份设计文档带原型，有的是有不过是后期开发完成后补的，这是聪明人做的事情。我看这份文档，到这里我已经完全明白要做什么了，至少我不会担心我要自己设计什么稀奇古怪的东西。另外这个sheet标注了项目说明，这样结合原型我又能多理解很多东西。说BUG大部分都是出现在需求和设计阶段，如果你能100%理解你要做什么了，怎么会让BUG穿透这么多层面流到客户地方去？ 5. 界面原形元素设定到这里我作为一个曾经的开发人员就要动手准备做了，本sheet详细描述了整个界面所用到的GUI元素，编程变量名称，类型，长度，格式例子等等，还有GUI元素的坐标。其实我理解到了开发阶段，基本上就是光做不说的阶段，你还能指望有几个开发需要大量的激情创造才能生存下去？所以说，国内的开发吃欧美的编程天才的毒蘑菇吃多了，产生了愉悦的精神幻觉，要知道图灵只有一个他死在美国！ 6. 界面原形元素数据实现顺序这个要详细看看，其实这个sheet我理解的也不是很好，但是从含义来看是对GUI接收和反馈数据作的一个约定，哪些GUI元素是接收数据的，哪些GUI元素是反馈数据的，感觉就是很细节，是对前面一个sheet的补充。 7. 动作实现顺序国内有个不好的习惯，习惯让测试人员最后写操作手册，我不知道这个是谁发明的并且第一个开始，我只知道这样的人在IT中对IT标准化是个莫大的嘲笑。这份sheet详细描述了整个界面的操作动作，结合界面元素的不同组合详细写出业务可接收处理过程，如果你要写操作手册，只要结合VBS就可以快速生成一份XX软件操作手册，何必再劳师动众让本已经疲于奔命的测试人员写呢？ 8. 底层数据集描述和实现这部分详细设计经过GUI收集的数据最终存储问题，国内很多都有这方面的描述，这一块日本作的实际了点，数据名称跟前太GUI元素作了捆绑指定，看了整个设计就通畅了。最后要说明的是，这只是一份普普通通的日本软件设计文档，设计的内容是一个很小很小的资金查询，这样的东西以前我一天可以做好几个，但是到今天为止我做不出这么详细的设计文档。我觉得现在非常有必要反思一下我的测试用例设计文档细节决定成败我不愿意落在口头上。今天的发文不代表任何含义，希望国内IT同仁们继续努力！
可不可不要这么样徘徊在目光内你会察觉到我根本寂寞难耐即使千多百个深夜曾在梦境内我有吻过你这毕竟并没存在人声车声开始消和逝无声挣扎有个情感奴隶是我多么的想她但我偏偏只得无尽叹谓其实每次见你我也着迷无奈你我各有角色范围就算在寂寞梦内超出好友关系唯在暗里爱你暗里着迷无谓要你惹上各种问题共我道别吧别让空虚使我越轨
[楼主] \| Posted: 2005-12-30 13:46

ilovejolly

级别: 测试新手
精华: 2
发帖: 43
基地声望: 20 点
基地币: 6652 Bug
基地贡献: 6 点
好评度: 0 点
在线时间:45(小时)
注册时间:2005-10-20
最后登录:2006-07-22

如果你去问，答案肯定是没时间

[1 楼] \| Posted: 2006-01-01 18:41

jameswang

级别: 论坛版主
精华: 0
发帖: 66
基地声望: 24 点
基地币: 383 Bug
基地贡献: 10 点
好评度: 2 点
在线时间:28(小时)
注册时间:2005-12-20
最后登录:2007-01-17

我是专门做日本外包业务的。对日本人写文档的功夫，我觉得任何一个国家的人都很难做到。（听说德国人的工作态度和习惯和日本人类似）他们的这种功夫是从小学教育就开始的。到了日本，如果你注意观察，就会发现能写出如此优秀文档的不只是IT人士，其他行业的也很强。说白了，日本人进入公司工作，用OFFICE做出精美的文档是最基本的要求。日本人对于系统的设计水平，我认为只能算中归中据。对于系统设计的过分细化，所造成的负担就是当需求大量变更时，文档维护量很大。日本人大多数比较固执保守，没有灵活的处世态度。所以，无论一个项目规模有多大，估价有多少，实际情况怎么样，他们都采用同样的设计方式来工作。结果，到了最后，面对大量的式样变更，他们也把握不住文档的版本和内容了。我想，我们应该像日本人学习的是一种工作态度，执著的精神。
孤独是一个人的狂欢
[2 楼] \| Posted: 2006-01-05 10:35

taker2001

级别: 助理测试工程师
精华: 2
发帖: 119
基地声望: 54 点
基地币: 6651 Bug
基地贡献: 81 点
好评度: 10 点
在线时间:129(小时)
注册时间:2005-10-17
最后登录:2007-04-03

能不能把这份文档共享一下呢

[3 楼] \| Posted: 2006-01-07 23:40

Fastpoint

呵呵，不能了，以后我改版一份自己的！
可不可不要这么样徘徊在目光内你会察觉到我根本寂寞难耐即使千多百个深夜曾在梦境内我有吻过你这毕竟并没存在人声车声开始消和逝无声挣扎有个情感奴隶是我多么的想她但我偏偏只得无尽叹谓其实每次见你我也着迷无奈你我各有角色范围就算在寂寞梦内超出好友关系唯在暗里爱你暗里着迷无谓要你惹上各种问题共我道别吧别让空虚使我越轨
[4 楼] \| Posted: 2006-01-08 10:20

windything

级别: 测试新手
精华: 0
发帖: 6
基地声望: 2 点
基地币: 6599 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:3(小时)
注册时间:2006-01-06
最后登录:2006-02-21

新手受教了：）！

[5 楼] \| Posted: 2006-01-08 11:34

xuewinds

级别: Cntesting老学员
精华: 0
发帖: 568
基地声望: 73 点
基地币: 0 Bug
基地贡献: 6 点
好评度: 2 点
在线时间:151(小时)
注册时间:2005-12-24
最后登录:2008-08-31

没看到样本？亲眼看见会比较有感触

[6 楼] \| Posted: 2006-01-09 19:33

bnx

级别: 测试新手
精华: 0
发帖: 4
基地声望: 1 点
基地币: 6597 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:0(小时)
注册时间:2006-01-10
最后登录:2006-10-19

要是可以看看就好了，期待你的修改版本修改完能发一份给我？ bnx000@163.com 万分感谢！

[7 楼] \| Posted: 2006-01-10 11:09

hqbluesky

级别: 资深测试工程师
精华: 0
发帖: 365
基地声望: 41 点
基地币: 6869 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:79(小时)
注册时间:2005-12-27
最后登录:2007-11-23

我在看需求分析的时候也有同感，如果需求说明描写得过分的详细，对于项目需求经常变化的情况下，文档和软件的版本控制就非常麻烦了。
该有的总会有!
[8 楼] \| Posted: 2006-01-10 16:47

wjjm

级别: 测试新手
精华: 0
发帖: 10
基地声望: 1 点
基地币: 6603 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:2(小时)
注册时间:2005-11-03
最后登录:2007-05-30

要写如此详细的设计文档要看公司的人力资源。在人力资源有限的情况下能出一份文档已经很不错了。

[9 楼] \| Posted: 2006-01-17 16:42

yilistien

级别: 测试新手
精华: 0
发帖: 19
基地声望: 3 点
基地币: 6443 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:12(小时)
注册时间:2006-07-03
最后登录:2006-09-30

我已经感慨好好久了！日本的文档和德国的文档，那是相当的有思路。而且，WORD和EXCEL使用相当重视，我们曾经被无数次培训OFFICE。遗憾的是我还没有看过国内的文档是怎么样子的。思想是重要的，有了这种根深蒂固的思想，做起文档这种东西就是习惯了。所以，也没有什么神秘的。

[10 楼] \| Posted: 2006-07-10 13:32

Fastpoint


可不可不要这么样徘徊在目光内你会察觉到我根本寂寞难耐即使千多百个深夜曾在梦境内我有吻过你这毕竟并没存在人声车声开始消和逝无声挣扎有个情感奴隶是我多么的想她但我偏偏只得无尽叹谓其实每次见你我也着迷无奈你我各有角色范围就算在寂寞梦内超出好友关系唯在暗里爱你暗里着迷无谓要你惹上各种问题共我道别吧别让空虚使我越轨
[11 楼] \| Posted: 2006-07-10 13:34

lilina130

级别: 测试新手
精华: 0
发帖: 5
基地声望: 1 点
基地币: 6428 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:7(小时)
注册时间:2006-06-26
最后登录:2006-07-28

QUOTE: *引用第11楼Fastpoint于2006-07-10 13:34发表的“”*: 刚做测试不久,如果可以的话,也给我弄一份吧,谢了! 我觉得斑竹很强啊,佩服……

[12 楼] \| Posted: 2006-07-11 11:56

吾爱吾爱

级别: 测试新手
精华: 0
发帖: 10
基地声望: -1 点
基地币: 6430 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:28(小时)
注册时间:2006-06-14
最后登录:2006-08-06

我也觉得传上来一份比较好,这样能有切身的体会.光看文字的描述,真的不好体会.
在为爱的路上狂奔!!
[13 楼] \| Posted: 2006-07-12 16:41

死鱼

级别: 测试新手
精华: 0
发帖: 27
基地声望: 1 点
基地币: 6447 Bug
基地贡献: 0 点
好评度: 0 点
在线时间:3(小时)
注册时间:2006-07-12
最后登录:2006-07-20

我也想一睹为快~
草※始终是一棵平凡的小草
[14 楼] \| Posted: 2006-07-12 20:30


软件测试基地论坛 -> 测试用例设计

软件测试基地是上海测仕信息技术有限公司旗下网站
Copyright © 2005-2007 Cntesting.com, All Rights Reserved
沪ICP备06057721号

Powered by PHPWind Code © 2003-06 PHPWind
Total 0.162344(s) query 5, Time now is:10-07 23:49, Gzip disabled
You can contact us

每日一句：Loading...