java交接文档_如何写好交接文档

没客观标准。谁接手让谁看。

我们重来不弄这个。接收的，移交的，两人一起做两周的结对编程，什么代码也都搞定。多年的复杂代码，２周接下来。当然两人都是高手，我这里也没低手。低手进不来，进来也待不下来。

很多时候，看起来是文档的问题，其实根本不是。你遇到的这个问题，是新手接代码，真正的问题是新手的业务和技术实力不够，而不一定是你的文档写的不好。

说的远点：我多年前带队伍，常常听到程序员说文档不足，其实不过是多个具体问题卡壳，有不愿意正对问题去解决，缺乏提炼问题的能力，以至于只能说，文档不足。何况内部的代码就那么几个人用(反正是内部用，怎么也比不上OS，常用系统软件的)，写文档干么。写了文档的人，会被点赞吗。代码就在那里。看啊，有问题就提啊。数据库的字段不懂，就问啊。代码逻辑混乱，写单元测试啊，重构啊，蚂蚁同大象改变现状；也有确实重构成本高的，痛下决心，重写一遍。

我的观点是比较极端的：说文档不足的，和现在动不动就说“没有音乐细胞”，“缺乏路联网基因”类似，是含糊的提法。是确实技术思维的人说出来的话。

确实要写的话，方法比较多，也需要一个修炼的过程，光是ＵＭＬ，Ｕｓｅ　ｃａｓｅ　一套东西，都很多人喝几年的。文档也没有编译器，没有机器帮你把关的。

说以，大部分问题，可以通过代码解决，即使业务代码本身不清，也可以先考虑单元测试，因为这些也是代码，并且和代码一起走。文档一定会过期的。能不写就不写。

java交接文档_如何写好交接文档相关推荐

离职交接文档_如何写好离职工作交接文档？
交接文档的重要性一个业务员与客户建立起了私下的信赖关系,可是当他因工作调动而离开原岗位,由另一个人接替的时候,原来的关系很可能就会一下子断裂. 百货商店也一样,如果柜台的营业员换人了,有些顾客就不会 ...
java离职交接文档_财务人员工作交接你知道么？没处理好不止将来风险大还可能违法...
今天给大家分享一下在工作中,财务人员应该怎么保护自己? 1.虚假报销那些事儿在企业内部报销程序中,部分管理人员往往安排下属或助理经办报销程序,所有的费用申请.报销单据的填写均系下属完成,而一旦虚假报 ...
项目交接文档_财务离职，交接工作需要交接哪些？附财务移交清册表！
盛戈会计会计师的摇篮年底了,随着中级会计成绩的发布,又到财务离职高峰期,这里小编总结了财务人员离职工作交接详细清单,供大家参考. 根据财政部最新通知,2020年度全国会计专业技术资格考试报名人数创历 ...
[AsciiDoc]_[项目管理]_[适合写书写需求文档的纯文本轻量级标记语言]
场景 markdown适合写短篇文章,但是不适合写书,需求文档这类复杂多页的文档.有什么文本格式适合写需求文档呢?并且能生成PDF或者docx格式方便阅读? 说明在阅读gradle的userguid ...
wms策略文档_内容策略：技术文档的新理念
wms策略文档我们是否可以首先同意文档很重要,而我们想要更好的文档呢? 好. 这样一来,我就不必为为什么要关心而写三段式的报告了,这样您就可以保留更多的时间来阅读它会花费您的时间. 为了生意! 作为 ...
echarts4离线使用文档_适合写API接口文档的管理工具有哪些？
现在越来越流行前后端分离开发,使用ajax交互.所以api接口文档就变的十分有意义了,目前市场有哪些比较优秀的接口文档管理工具呢? 1.MinDoc 网址:https://www.iminho.me/ ...
django文档_如何在django官方文档中快速找到需要的内容
许多新手程序员发现Django文档内容非常庞大. 假设想学习如何为用户执行登录.看着很简单:登录是Django的核心功能.如果搜索" django登录"或搜索文档,则会看到一些选项 ...
sphinx文档_使用Sphinx构建自定义文档工作流
sphinx文档 Sphinx是用于创建文档的流行应用程序,类似于JavaDoc或Jekyll. 但是,与其他工具相比,Sphinx的重组文本输入允许更高程度的自定义. 本教程将说明如何自定义Sphi ...
word文档里怎么嵌入文档_如何在Microsoft Word文档中嵌入字体
word文档里怎么嵌入文档 When you email someone a copy of your Word document or PowerPoint presentation and the ...
离职交接文档_离职程序员交接工作被同事怒怼：每一行代码都讲清楚，不然投诉你...
我们都知道,员工在离职之前都要完成一份工作,那就是交接工作.在工作层面上讲,这样做算得上是有始有终了,在道德层面上讲,我们不能说走就走,把摊子就给别人,这是不负责任的表现. 交接工作也需要我们认真对待 ...

java交接文档_如何写好交接文档

java交接文档_如何写好交接文档相关推荐

最新文章

热门文章