一.敏捷宣言二解读：可以工作的软件赛过完备的文档
糟粕所传非粹美，丹青难写是精力
传统的软件开发过程对文档的要求每每达到失常的水平：每个方面、每个阶段都需要大量的文档，每份文档都要求非常详尽，每份文档都要颠末多次评审-修改循环。大量的时间和精力泯灭在文档上面。大家都屡见不鲜，没人想到过要改变。
文档的主要作用是作为沟通的工具，把一个人的想法、意图以及关于软件产物的知识传达给另外的人。至少从这一点来说，文档是有用的。问题不是要不要文档，而是与可工作的软件相比，文档有多重要？谁是主谁是仆？不能买椟还珠，恶紫夺朱。胎盘的作用是为胎儿提供营养，一旦婴儿生出来，胎盘就该丢弃了；脚手架的作用是辅助建造房子，房子建好之后，脚手架就应该拆除。Martin Fowler等人主张将UML写在咖啡杯垫纸上，其含义是：UML等文档不用那么严肃，应该是两个人在喝咖啡的时间沟通讨论，在咖啡杯垫上写写画画，一旦取得共识，就把它丢弃。不要写一个精致完备到你舍不得丢弃的文档，不要把盒子造得比它用来装的珍珠还贵重。
首先，从沟通的有效性来说，文档的效果差不多是最差的。
最有效的沟通方式是面对面沟通，其次是视频会议（假设带宽够大，视野够广），再其次是电话，再其次是QQ等即时通讯工具，末了才是正式文档和email等等。文档是单向的，它不能回答未预期的问题。我们不需要像录音机那样的单向播放，我们需要跟作者循环往复的交流，这样才能把问题搞深搞透。
其次，从完备性的方面来说，文档只是对软件的单方面的反映。
不管你对软件的描述多么丰富，都不大概达到软件本身那么详细。有这么一个寓言：或人很歆慕琴师的高超技艺，请琴师描述一下琴曲的优美之处，琴师二话不说，直接给他弹了一曲。或人说我听完了，请你描述一下它的优美之处。琴师二话不说，重新给他弹了一遍。琴师的意思是：琴曲的美妙之处就在琴曲之中，一切语言的描述都是不准确、不全面的，是多余的。软件也一样，它的原则、意图和机制都体现在软件本身之中，而不是在文档内里。
第三，从准确性的方面来说，文档每每是对软件的错误的描述。
因为文档是外在于软件的，我们无法包管文档准确地反映了软件的内涵状态。软件不会骗人，它有没有实现功能需求，有没有达到吞吐量指标，是清楚而无二义的；文档则不然，一个破败不堪的软件其文档也可以写得花团锦簇。另一方面，即使文档准确地反映了当时的软件计划，随着软件的重构和进化，如果不实时更新（这是常态，因为程序员喜欢写代码而不喜欢写文档），文档也会快速变得过时。过时的文档会误导读者，过时的文档比没有文档更有害，它会引导球员把球踢进自家的球门。
软件开发不是文档开发。客户要的是可工作的软件，不是文档。开发人员是程序员，不是作家。我们绝大部分的精力应该使用在分析、计划、构建和验证软件上，需要沟通则通过简短的会议或面对面交谈，而不是通过文档的传递。只管将需求体现在验收测试里，架构体现在模块和分包里，API体现在单元测试里。我们还需要文档，但文档的数量要尽大概的少，文档的内容要尽大概的短。文档应该只用于勾勒体系的高层概貌和计划原则，一切详细细节都应该深入到代码内部去搜寻了解。当然这样一来，就要求你的代码的可读性高，代码布局可以或许反映计划意图，但这不正是精良的代码应该达到的标准么？你不应该期望通过精良的文档来弥补代码的腐臭，将文档当做代码的遮羞布和除臭剂来使用。
我们要一个精致的软件，而不要一批精致的文档。如果软件是西施，粗服乱头亦不改国色；如果软件是东施，袨服华妆亦难遮其丑。可以工作的软件证明一切，完备的文档啥也证明不了。
从一位在ThoughtWorks工作的旧同事那边相识到，他们一个软件项目开发两年了，客户和产物司理在澳洲，开发人员在中国。他们通过视频会议交流，通过主动化构建和持续集成跟踪工作进度。最突出的是：这样一个大规模的、异地的、开发人员操差别母语的、业务关键的（保险业）软件，从开发至今，一份文档都没有。
二.实践思考
本人正在实践敏捷管理，如上是摘自部分敏捷实践者的观点，我并非完全赞同。在如下观点的底子上，我想补充的是，在制造业下的IT是很难做到分工及其明细的，我们的小伙伴们除了要开发产物还要运维产物。
在产物的整个生命周期内，文档或文字记载应该怎样开展，做到哪个颗粒度？
1.产物从无到有：
基本在项目制的环境下诞生，故怎样以最小的代价将项目做好是关键的。这个阶段我是赞同如上很多观点的。小伙伴们要输出构造要求输出的文档即可，这些都是构造颠末反复讨论的，考虑到了项目过程中软件质量的问题，也考虑到了后期的运维，知识的传递。
2.产物运维阶段：
若存在运维和开发不是同一个小伙伴，请做好上一阶段知识承接。整个运维是漫长的过程，请将运维知识登记到体系。这个登记的过程，现实上是很难约定颗粒度和质量的，我个人的看法是运维分类>问题描述>办理方案：
我们要思考运维记载谁会看？目的是什么？
是给本身看嘛？痴人说梦吧，扪心自问，你登记的问题，你会再去查阅嘛？险些不会，早在本身脑瓜里了。所以办理方案，问题描述甚至归档对你都不重要。本身记载的目的是知识输出。
是给业务运维人员看嘛？也不完全是，有多少业务运维人员能看懂开发人员登记的问题，开发写的再详细也无法办理知识缺失的问题。业务运维人员大多只能看懂问题描述和归档。故对于业务运维人员来说问题描述和归档>办理方案。业务运维看的目的是能否通过汗青记载快速定位用户问题，以确定该找谁处置惩罚。
是给管理人员看嘛？占大部分吧。很多管理者无技术背景，或技术背景单薄，再或长久不下一线，根本不知道问题怎样产生的，每天就靠小伙伴汇报环境，缺乏实践。导致有时并不能看懂问题描述，更别谈办理方案了。但是有个东西叫归类，这个很重要，管理者可以通过归类来诊断构造的问题发生环境，进而倒推哪些需要关注，用管理的手段推动构造中各级小伙伴重新审视已经归档的问题描述和办理方案，来低落运维问题，提升构造服从。
总结下第2点，运维阶段登记的意义在于驱动构造更好的运维。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。 |
