在脑海中想像这些代码
我们能够容易地想象出有关ButtonDiallerAdapter 的代码。如Listing 2-2 所示。当你做
图的时候能够想象到你的代码是极其重要的。我们把图当作了解代码的一条捷径,并不是替
代代码。如果你画着图但是不能想像出它代表着什么样的代码,你是正在空气中建筑着城堡。
停下来你正在做的,想想如何如能将它可以转化成代码。不要为了图而画图,你必须时时
刻刻记得,代码才是你要表现的。
文档的量:(效率第一的原则)
对于一个有12 个人共同工作、编写100 万行Java 代码的项目团队,我想会固定保存
的文档将会是25 到200 页,我本人宁愿是更少。这包括一些有关重要模块的高层结构的
UML 图的文档、关系型模式的ER 图、一到两页纸描述如何建立系统、测试指令、源代码
控制指令等等。
我将把这些文档放到一个wiki 中,或有些协作编写工作中,这样团队中的每一个人都
能够从他们的屏幕上访问或搜索到它们,每一个人都能够在需要的时候更新它们。
需要花一些功夫去让文档变小,这样的工作是有意义的。人们将会阅读小的文档,而不
是上千页的大部头书。
我们能够容易地想象出有关ButtonDiallerAdapter 的代码。如Listing 2-2 所示。当你做
图的时候能够想象到你的代码是极其重要的。我们把图当作了解代码的一条捷径,并不是替
代代码。如果你画着图但是不能想像出它代表着什么样的代码,你是正在空气中建筑着城堡。
停下来你正在做的,想想如何如能将它可以转化成代码。不要为了图而画图,你必须时时
刻刻记得,代码才是你要表现的。
文档的量:(效率第一的原则)
对于一个有12 个人共同工作、编写100 万行Java 代码的项目团队,我想会固定保存
的文档将会是25 到200 页,我本人宁愿是更少。这包括一些有关重要模块的高层结构的
UML 图的文档、关系型模式的ER 图、一到两页纸描述如何建立系统、测试指令、源代码
控制指令等等。
我将把这些文档放到一个wiki 中,或有些协作编写工作中,这样团队中的每一个人都
能够从他们的屏幕上访问或搜索到它们,每一个人都能够在需要的时候更新它们。
需要花一些功夫去让文档变小,这样的工作是有意义的。人们将会阅读小的文档,而不
是上千页的大部头书。