首页 > 后端开发 > php教程 > 请教下你们团队中有文档吗?哪些内容是需要专门的文档来记录的?

请教下你们团队中有文档吗?哪些内容是需要专门的文档来记录的?

WBOY
发布: 2016-08-29 08:50:52
原创
1010 人浏览过

在一个创业公司从零开始写程序一年多了,现在老板提出要文档化,要让新来的人也能快速上手项目,我不知道应该写哪些东西到文档里,可能写进去的过段时间后代码就被别的同事改了,文档就不对了,我要不要写文档,写什么,或者有更好的方式?

回复内容:

在一个创业公司从零开始写程序一年多了,现在老板提出要文档化,要让新来的人也能快速上手项目,我不知道应该写哪些东西到文档里,可能写进去的过段时间后代码就被别的同事改了,文档就不对了,我要不要写文档,写什么,或者有更好的方式?

  1. 代码修改记录

  2. 数据库修改记录

  3. 出现的问题,解决的办法

  4. 同事修改的话,要让同事更新到文档内容醉后面,别直接替换

我觉得首先交代一下公司项目的基本流程和规范比较好,比如新来的可能不一定知道公司之前的一些工作记录,搞不好做了重复工作和瞎折腾。可以先简单说明一下公司项目中用到的一些工具,框架,平台的基本介绍和相关链接;然后是公司编码规范,基本业务,工作计划(Todo),代码管理;然后是之前在工作过程中遇到的一些问题和解决方案,避免新人继续入坑;最后可以给新手推荐一下公司业务可能涉及需要去学习了解的技术栈。

php开源的DokuWiki

这本来就是一个坑,开发的时候没写现在写。
不过可以给些参考:
系统设计文档、数据库设计文档、接口设计文档、网站布署配置文档、网站使用说明文档等

相关标签:
来源:php.cn
本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板