开发软件几年,从小项目做到大项目.感觉最深的一个问题就是编号的使用.
对于大型项目,最好约定编号来治理文档,变量,项目....
一 文档约定
01可行性分析报告
02项目开发计划
03软件需求说明书
04概要设计说明书
05具体设计说明书
06用户操作手册
07测试计划
08测试分析报告
09开发进度月报
10开发进度月报
11软件维护手册
12软件问题报告
13软件修改报告
注重,以上文件开头都是编码了的。
那么,对于文档编号:
01 ~ 20: 留给规范化文档
21 ~ 50: 留给非规范化补充文档
51 ~ 99: 留给辅助文档,或者参考文档
二 变量约定
Global g_sys(26)As String'收集常规报告所用参数
'g_sys(0):gClientName variant
'g_sys(1):variantname
'g_sys(2):SavePath
'g_sys(3):modlepath
'g_sys(4):gColumnConditionhorizonewhere
'g_sys(5):gAttribConditionhorizonewhere
'g_sys(6):gHnList str0 h1,h2,h3,
'g_sys(7):gLastShowName lastitem无品牌
'g_sys(8):gWhereCondition abcabcabcooooooooooooooo
'g_sys(9):排序方法1
'g_sys(10): gHnListCount3
'g_sys(11): gShowIt(0)BRAND
'g_sys(12): gShowIt(1)VARIANT
'g_sys(13): gShowIt(2)PACKSIZE
'g_sys(14): gShowIt(3)
'g_sys(15): gShowIt(4)
'g_sys(16): gShowIt(5)
'g_sys(17): gShowIt(6)
'g_sys(18): gShowIt(7)
'g_sys(19): gAttribCount3
'g_sys(20): gShowAttrib(0)a1 (自定义)
'g_sys(21): gShowAttrib(1)a2 (自定义)
'g_sys(22): gShowAttrib(2)a3 (自定义)
'g_sys(23): gShowAttrib(3)a4 (自定义)
'g_sys(24): gShowAttrib(4)a5 (自定义)
'g_sys(25): gShowAttrib(5)a6 (自定义)
'g_sys(26): gValueShare 100
好处:这样在团队里对所有的参数有共识!
三 参数表约定
PSZ01: 记录时间
PSZ02: 记录地点
..............
PSZ99: 记录标志
好处:这样在团队里对所有的参数表有共识!并且在系统中,这几个参数表怎么排列都在一起,便于查看.
因为在SqlServer中,表名以数字开头要加[].所以可以考虑加上字母
四: 项目
当项目做多了以后,往往会发现自己项目目录中很乱.所以用上编码:
工程项目号资源,采取倒序递减原则。
Z99~Z00: 一般重要项目
A99~A00:重要项目,开发时间长的项目
在VSS中,这样的方法还能够保证关注的项目始终在VSS中,不需要拖动才能找到
五: 文件目录
对于资源:
R01Enjoy:
R02Live:
R3Work:
R09Baksoft:
对于工作:
W01VB代码参考
W02酒店软件
W03下一站代码
...
W99参考源码
总结:
当我们在文档;变量;参数表;项目;文件目录采取编码以后,发现如下优点:
1 可以控制更多信息
2 一旦约定并且养成习惯以后,可以快速找到相关信息
3 编号只能运用到经常用到的场所.这样避开晦涩的编码,成为快速查询的工具