文档驱动式超敏捷开发

简介:     敏捷开发大家都不陌生,他对文档的态度是偏向于反对,但是也不是说一点文档都没有。他的说法是 代替文档。     那么敏捷开发为什么会这么认为呢?其实大家在做项目开发的时候都会有这样的体会:     时间紧任务重,哪有时间写文档呀?代码都写不过来。

 

 

  敏捷开发大家都不陌生,他对文档的态度是偏向于反对,但是也不是说一点文档都没有。他的说法是 代替文档。

 

  那么敏捷开发为什么会这么认为呢?其实大家在做项目开发的时候都会有这样的体会:

 

  •   时间紧任务重,哪有时间写文档呀?代码都写不过来。
  •   辛辛苦苦把文档写好了,但是但是项目才进行一小半好不好,需求怎么就变了呀!需求变了,代码都改不过来,那还有时间去修改文档呀?于是乎一开始写好的文档就变成了一个个的坑。默默的坑着后来的人。

 

  于是就有了这样的现象:

  •   当接手一个遗留项目的时候最希望的就是有文档,但是没有文档——郁闷;
  •   啥?!找到文档了,太好了……但是当看完了文档再去看代码的时候就会——更郁闷。

         (各位前辈呀,为后来人着想着想呀!)

  •   等自己完全接手项目,流程都弄明白了之后呢?忙改代码做新功能,至于文档?哪有时间去想文档呀。

 

  于是乎文档就成了一个包袱一个累赘,有还不如没有。

 

  为啥会这样呢?因为文档和代码没有直接关系,没有“联动”关系!

 

  那么啥是联动关系呢?我们举个例子,PowerDeszner做数据库设置的时候,我们不仅可以用这个工具做数据库文档,而且设计好了之后,还可以直接创建数据库。当文档有变化的时候,也可以自动修改数据库。还可以反向工程,就是指定一个数据库,然后根据数据库里的表和自动,自动生成文档。这就是联动。

  如果您对powerdes不熟悉的话,我在举一个CodeFirst的例子。CodeFirst就是先写代码设计类,然后用vs里面的来自动创建数据库,类结构发生变化了,可以自动的去修改数据库的表结构。这样就可以达到代码和数据库的一致性,而且有变化只需要修改一个地方(代码)就可以了,另一个地方可以自动变更。

  这就是我所说的“联动”。如果所有的文档都可以和代码进行这样的联动,需求有变化了,先去修改文档,然后代码会自动随之变更,那么文档就不会成为负担了!

  这就是我所说的“文档式驱动”!

  当然在实际中,并不是所有的功能都是先文档在代码。而是根据具体的情况来灵活控制的。

  这里在举一个WebAPI的例子。我们打开VS201*,新建一个webapi的默认项目,我们会发现有一个help的目录。进去一看,哇,api的使用文档!有接口名称、参数名称和他们的注解,还有调用实例。这还不是最神奇的,更神奇的是,当代码修改了之后,help里面的内容也会随之更新。这样写接口再也不用担心更新文档的问题了。

  这是有代码“生成”文档。这个仅仅是对程序员来说的,写代码用的文档。除此之外还有给客户看的文档,等等。如果这些都可以“联动”起来,做到有需求的时候,只需要改动一个地方,其他的地方都会随之更新。这是不是很爽!

 

  可能有人说,我这是痴人说梦,该醒醒了,别浪费大家宝贵的时间。这个当然不是无稽之谈,今天也不是愚人节。下面还是用例子说话。

  公司以前用asp.net mvc做项目。后来发现开发速度跟不上,于是找了一个国外的无后端的东东 ,叫做backendless。他的思路就是,凡是服务器做的事情(UI除外),都可以不用写代码了,都由他来包办。Backendless提供了一个平台,在这个平台上面配置各种服务,配置完了前台就可以直接调用。这个前台包括:web、手机web、安卓、苹果、flash(Flex)、等,并且可以生成对应的调用代码。我们写点前台代码就OK了。

  每一个环节都有人在做“联动”的事情。只是从整个项目的角度来看,把各个环节用一条线,从始至终的串联起来,让各个环节可以“联动”。目前还没有发现做这种事情的人(自己除外)。

  这么做的难度很大,推广也很难。其实大多数的情况都是只做一块,比如选择日期的my97,分页的Aspnetpager,在线编辑器,各种ORM,各种UI,单点登录,用户中心等。他们都只做一块,其他的不管。这样才能够让大家灵活的选择和使用。

  再举一个盖大楼的例子。要盖楼首先要一个图纸,然后请建筑公司来按照图纸把大楼盖出来。盖楼之前图纸可以修改,盖楼的时候会按照最后修改后的图纸来施工。但是楼盖好了,再去改动图纸,大楼就不会受到影响了。大楼改好之后,图纸和楼失去了联动,图纸不会去影响大楼了,因为楼已经盖好了。

 

  再来看看导航软件,我们输入出发地和目的地,然后导航就会规划一条路线出来,我们按照这个路线开车,开着开着发现前方路口堵车,怎么办?重新规划路线绕过堵车点。然后我们按照重新规划好的路线继续行驶。路线实时指导我们的行车方向,路线变了,我们的车就跟着变。这样就是实时联动。

 

  说了这么多,大家可能都蒙登了,我到底要说啥?还是来张图吧。

 

 

 

 

  总之呢,就是不能让文档孤单单的存在,要让文档和代码和页面互动起来。需求有变化了,首先想到的是改文档,然后对应的地方会随之自动更新,不需要修改代码!

 

  最后说一下啥是“超敏捷”,前面说了敏捷开发,那么超敏捷开发呢,顾名思义说的就是开发速度会更快。

 

 

ps:好久没有写博客了。沉寂了一段时间,好好的思考了一阵子,现在是新的开始,重新打造!后续会更精彩。

 

相关文章
|
3月前
|
持续交付 C# 敏捷开发
“敏捷之道:揭秘WPF项目中的快速迭代与持续交付——从需求管理到自动化测试,打造高效开发流程的全方位指南”
【8月更文挑战第31天】敏捷开发是一种注重快速迭代和持续交付的软件开发方法,通过短周期开发提高产品质量并快速响应变化。本文通过问题解答形式,探讨在Windows Presentation Foundation(WPF)项目中应用敏捷开发的最佳实践,涵盖需求管理、版本控制、自动化测试及持续集成等方面,并通过具体示例代码展示其实施过程,帮助团队提升代码质量和开发效率。
65 0
|
4月前
|
监控 数据可视化 项目管理
项目管理利器:揭秘软件如何驱动效率与成果并进
项目管理软件助您高效工作,通过WBS分解复杂任务,与Google Apps等工具无缝集成,实现任务自动化,利用甘特图追踪进度,加强团队协作沟通,并监控预算变动,提升效率,减少错误。 1. WBS将大项目拆解成小任务,便于管理和追踪。 2. 无缝集成常用工具如Google Apps、Slack等,简化工作流程,促进信息共享。 3. 自动化重复任务及流程,节省时间,专注核心工作。 4. 甘特图可视化项目进度,明确任务依赖关系,及时调整策略。 5. 强化团队协作与创意交流,支持聊天、会议及论坛互动。 6. 实时监控项目预算,对比计划与实际成本,预防超支风险。
27 0
|
6月前
|
敏捷开发 Devops jenkins
DevOps、瀑布模型与敏捷开发:关系解析与对软件交付工程师的影响
DevOps、瀑布模型与敏捷开发:关系解析与对软件交付工程师的影响
144 1
|
敏捷开发 测试技术 项目管理
​ 敏捷开发和传统开发的区别?以及Scrum敏捷管理工具推荐
Leangoo领歌一款永久免费的专业敏捷研发管理工具,它覆盖了敏捷项目研发全流程,包括小型团队敏捷开发,规模化敏捷SAFe,Scrum of Scrums大规模敏捷。能够支持多种场景,如:敏捷研发管理、敏捷项目管理、工作流管理、轻量级项目群管理、任务管理等。
|
存储 XML 缓存
「领域驱动设计」领域驱动的设计和开发最佳实践(下)
「领域驱动设计」领域驱动的设计和开发最佳实践
|
存储 XML 缓存
「领域驱动设计」领域驱动的设计和开发最佳实践
「领域驱动设计」领域驱动的设计和开发最佳实践
|
存储 设计模式 缓存
「领域驱动设计」领域驱动的设计和开发最佳实践(上)
「领域驱动设计」领域驱动的设计和开发最佳实践
|
SQL 前端开发 安全
【测开方法论】如何简单的对测试平台进行底层重构 ?
【测开方法论】如何简单的对测试平台进行底层重构 ?
|
Android开发
以开发人员方式交付设计
本文讲的是以开发人员方式交付设计,首先,这将是本文中唯一一次提到 Photoshop。现在是 2017 年了,为自己好,去下载 Sketch(或者 Figma — 只要不是 Photoshop 就行) 用吧。
1311 0
《规范敏捷交付:企业级敏捷软件交付的方法与实践》——3.1 专业术语库
本节书摘来自华章计算机《规范敏捷交付:企业级敏捷软件交付的方法与实践》一书中的第3章,第3.1节,作者:(加)安布勒(Ambler, S. W.),(加)莱恩斯(Lines, M.)著, 更多章节内容可以访问云栖社区“华章计算机”公众号查看。
1194 0