当前位置:刘伯温心水图库本港台 > 软件文档 >

为什么许多软件开发团队与个人都不(爱)写开发文档

  可选中1个或多个下面的关键词,搜索相关资料。也可直接点“搜索资料”搜索整个问题。

  安徽新华电脑专修学院始建于1988年,隶属于新华教育集团,是国家信息化教育示范基地、中国 IT 教育影响力品牌院校.

  不写文档的原因很多很复杂,有合理的,也有不合理的,有主观原因,也有客观原因,待我述来。

  诸如 MS、Oracle、IBM 之类的一流大厂的软件开发文档写得怎么样,大家有目共睹,不用我赘述。

  三流组织是指那些连管理层的基本诚信都有问题的企业或团队,组织的文化、管理与技术基本上是可以用“烂”字来形容的(可能个别的技术还不错),所以普遍的是没有文档,即使有的话也极难读。如果您不幸落入了三流团队,不写文档(以免给自己的利益带来损害),我当然是举双手赞成的,不但尽量不要写、少写,而且要赶紧跑,跳出坑。

  麻烦的是二流组织。根据以上分布模型,江湖上最多的其实是中不溜秋的二流组织,文化、管理与技术都处于中游水平。我们重点来谈谈二流组织。

  一般二流团队的领导与员工都知道软件工程管理与开发文档的重要性,但由于内部文化、管理、技术上的一些欠缺,加上外部市场(与一流企业)的竞争压力,导致软件工程与研发管理的整体水平不高,开发文档的质量管理上或多或少都存在着一些问题。

  原因 9 许多初创团队不写文档或文档少,这是合理的,因为都赶着要尽快正式发布一个初始产品以争取市场份额与关注度,而在产品需求、架构都还很不稳定的情况下,如果要在代码+注释之外再拿出详细的开发文档,确实时间与精力都不够。

  他说出了很重要的一点。二流企业团队中这种情况是比较突出(大家心照不宣)的:个人与团队、公司之间存在的一种微妙的博弈(制衡)关系。

  你用心把文档写好了,让大家都迅速看懂了,领导、同事、用户都很满意,真的、必然对自己有好处和好报吗?不一定吧。

  在一些不太有利的商业环境下,出于个人职业保护的目的,不写、少写文档或者把文档写得模糊、晦涩一点,让想了解的人自己去看复杂的源码而不是立马就明白了,这我是赞成的,尤其是某些二乙、二丙团队。

  原因 8,许多知名开源软件表面上看着都是代码,独立的文档少,还有一个潜藏的原因(设计):

  你想尽快看懂的话,让你去买作者们写的书(付书费),参加各种技术大会与培训(付报名费、会议费和培训费),最好再找作者咨询(付咨询费),这其实是一种比较流行的开源商业(赚钱或补贴)模式。

  当然,也可以把这些详细解读的书看作文档,只不过要付费获得。如果采用这种模式,当然是免费的文档越少越好。

http://jeffcafone.com/ruanjianwendang/490.html
点击次数:??更新时间2019-06-25??【打印此页】??【关闭
  • Copyright © 2002-2017 DEDECMS. 织梦科技 版权所有  
  • 点击这里给我发消息
在线交流 
客服咨询
【我们的专业】
【效果的保证】
【百度百科】
【因为有我】
【所以精彩】