系统分析的文档基本写完了,最近听说要加个测试计划,再议罢,那也是小事了。
曾经无比想在搞定这纠结了大半个学期的文档后写一篇blog,连开头都想好了:“由这一刻我的人品由负归正……”然而和所有长时间的活计一样,当你最后把它完成了,无论你爱极了它或者烦极了它,你都没有那种极具张力的叙述把激越的文字弹射到纸面上,略记一点这大半个学期文档写作的得着吧。
其实我初期给它的界定是“决不应付”,之前没有估计以后也不会有这样的机会,自己作为从系统分析到程序设计的所有角色出现在一份文档里,好比演员在一部戏里分饰多角,那感觉要多爽有多爽,但在process中我发现这需要基于一个几千块的小系统写一份几十万系统规模的文档,所有关于扯字的词汇瞬间在我脑海中发芽开花。我不反对做大量的工作,我甚至也不反感做大量我看不到意义的工作,但要说做明明可以以少量工作替代的大量工作,我不觉得这是件明智的事,尤其是所有的这些重复而不实事求是。
每次听到xp那句“呃……还是……写一下罢”时都异常崩溃,我不确定他老人家确定自己希望看到一份怎样的作业。而每次点开那个文件夹,我告诫自己,“责任,责任……”我的兴趣在于开发,但有责任在这前面的时候,应该够上这个底线,java一点说,兴趣是个private,而责任是public的,很多方法等着调用。YiZin这条DNA很好很好。
AK君在校内留言说文档写作是IT民工的基本工,在process中多有体会,写文档时我喜欢走个神,想象下这个系统值几十万,想象一下会由十几口人联合开发,感觉写文档还是个深有可究的活计。
虽然用了YiZin的资料夹,但是总体来说我们是把它当FTP使得的,于是我们同一个设计报告的多个版本之间联系其实是断裂的(或者好听一点叫简单增量吧),单人/双人负责维护单个文档的多个版本其实一不利于文档规模的生长,二不利于文档的sharing和多人修订(这其实是某些文档从可读到可用的重要因素,窃以为),我们需要一开始引入一个文档的版本管理软件,到中道想起,为了保持连贯性就没有提,作为一个技术方面给出支持的人,我在这上面缺乏足够长远的眼光。
然后是命名统一的问题。其实这个量的文档,我们用来规划全局的时间还是太少,很多命名需要及早预见并统一的,好几份报告我在修订的时候都做了一些去除命名差异的工作,但估计还是有很多漏过去的,排版的两位女士麻烦多操心了。
最后是关于程序接口,我觉得,经此一役再让我control大规模的文档写作(不是这种文档和程序规模完全不对等的路数),我肯定会要求所有程序的所有接口出来checklist,精确到类型和变量命名规则。各个模块在旷日持久的开发完成测试好后准备release时发觉接口对不上,灾难。
谨在此感谢Pronergy的四位teammate,大家共同营造了一种非常好的团队氛围,不拖沓,有效率,精益求精,对得起专业力量四个字。在我视野不够开阔视线不够长远带来的大大小小问题后,大家依然出色的完成了任务。
希望我们的努力能告诉后来人,在这里劣币驱逐良币也不是必然的,踏实专注到底会得到认可。后面文档的收尾和开发的起步,加油。
莫堕英雄之志,天下当有大同。
December 15th, 2008 at 3:38 pm
go pronergy ~~~
December 15th, 2008 at 4:04 pm
你说的那个规划问题我也有同感,虽然文档都有,但是衔接性是有点问题~~ 下次注意就好了
December 15th, 2008 at 5:22 pm
嘿嘿~~我现在鸠占鹊巢地用同学的电脑上的,你写得好长呀~~下次再细看:)
我们pronergy真棒~~哈哈哈哈
December 15th, 2008 at 5:23 pm
楼上的名字~~~哈哈哈哈
December 15th, 2008 at 5:27 pm
我上面的留言是说黄某人的哈~我一下晕了~
December 15th, 2008 at 6:56 pm
来晚了~~
你的博客实在是太火了
December 15th, 2008 at 10:10 pm
To 舒~:一下留三个言我的留言数瞬间上去了哈哈哈~
December 15th, 2008 at 10:10 pm
To weakow:抢沙发需要一点难度~
December 15th, 2008 at 10:11 pm
To 黄所长:嗯,不过接下来的交互少很多,主要还是排版的时候要校准一下
December 15th, 2008 at 10:34 pm
文档在工作中是你的门面。
写不好文档,你就只好去写程序了。
December 15th, 2008 at 10:36 pm
To poppy:不是写程序的同时要写相应的文档吗?
December 15th, 2008 at 10:43 pm
sf
December 15th, 2008 at 10:44 pm
晕.原来是没刷出来…日
December 15th, 2008 at 10:47 pm
兄弟你都十三太保了,还沙发,别日……
December 15th, 2008 at 10:59 pm
地核都没了~~~~唉
December 15th, 2008 at 11:10 pm
哇~
好长呃……
好多人呃……
December 16th, 2008 at 12:04 am
呵呵,写得很让人有感而发啊,你的存在让我们大家都感觉很安心,我也很爱我们这个团队,和大家一起努力工作是我大三生活中很美好的时光,我把这个放到我收藏夹了,会经常来看的,注意更新的频率和质量啊,^_^
大家一起好好把活儿干,oh yeah!哈哈
December 16th, 2008 at 9:50 pm
超吊的~
这么火~~~
December 17th, 2008 at 3:55 pm
哇哇哇哇~!你这里好热闹,我也来插一脚~~哈哈哈~~
December 17th, 2008 at 11:20 pm
to yanglu: 订阅吧订阅吧,收藏夹多麻烦,呵呵
December 17th, 2008 at 11:21 pm
To 崔玮:黄所长旺场功劳不少呢~
January 2nd, 2009 at 10:00 pm
好耐無上嚟啦。
唉……寫一個總結真是好需要恒心、耐心、細心,所以通常想寫,但是就嘔唔出一個字,好似你咁寫咁長,又咁深刻,好難……