最近接手了几个项目,发现一个普遍现象:代码写得挺好,但文档基本为零。问前任开发为什么不写文档,得到的回答基本是"代码即文档"、"没时间"、"写了也没人看"。 但实际接手的时候真的很痛苦,业务逻辑全靠猜,配置项靠试,部署流程要自己摸索。花在理解项目上的时间比实际开发还多 开发者, 文档, 时间
说起这个想起之前上班的时候负责一个服务,写了详细的接入文档。 有人过来找我我先让他看文档。 结果有个老哥就是不看,就是要过来找我,让我手把手给他弄,后面看到他因为这个举动被评上了积极推动项目之类的奖项。 我都快成反面教材了,傻眼了。😂
If the code is really good enough, document is not necessary.And actually, you just need feature story, that's not programmer's business, you'd better ask