程序员工作文档都写在哪里(程序员的word)

http://www.itjxue.com  2023-04-09 12:18  来源:未知  点击次数: 

我是个编程的自学者,想当程序员不知道公司写文档是什么意思知道的情给我解释一下,还有具体是怎样工作的

以鄙人在软件公司工作的经验与你分享一下吧。

我们平时做项目,一般有一半以上时间都在管理文档,包括基本设计书,详细设计书,静态样式书,各种UML建模图,单体测试书,系统测试数,结合测试书,DB设计书,DB脚本,以及各种工具类管理文档,如资源文件管理,VBA管理等等,这还不包括项目前期的需求建设书,项目中期与客户交流的反馈书,项目后期的BUG管理书,以及贯穿项目的工程进度表和版本控制书。当然你的代码资源(包括注释,图片,脚本等)也属于文档,需要统一管理。

对于追求简短快的团队,未必会太重视文档的组织与管理,但是一定要相信文档看似浪费时间,其实无形中提高了很大的效率,而且在未来的开发提供了宝贵的参考资料。属于团队积累的一种。

软件开发需要编写哪些文档?

这个问题没有一定的,因为这里有多种因素

如,开发阶段、文档化要求程度等,若是通过CMM评估的,文档就较多

一般的是按项目开发过程来分,基本的有

可行性研究报告(若是一个新项目且未确定的或应客户要求时需要,实际上大部份公司很少有这文档)

用户需求说明书(用户+开发人员共同确认)

软件需求规格说明书

设计说明书(体系结构、详细设计)

测试用例

用户手册

实现代码

这些文档中,包括一定的分析与设计图形,如用例图、数据库结构、ER图等

当然项目计划、测试计划也应算在内

其它的(如CMM要求的)

风险、估算方面的,质量保证方面的、配置管理方面、定义的模板、度量数据库等

具体需要多少文档就是要看项目实际

这方面的东西,可参考一些软件工程类的书

程序员在哪里写文档

GitHubPages。

现在大多程序员都会使用通用代码库Github,所以对于希望保存文档的程序员来说,Github是一个不错的选择,尽管很多人只是利用代码库中的readme功能来为项目提供简单的操作指南,但这并非是最好的办法。

ReadtheDocs。

顾名思义,ReadtheDocs为开发人员提供了一个集中的平台来保存文档,这样用户就可以直接阅读文档了。它的工作原理有点类似GitHubpages,因为开发人员可以从他们喜欢的版本控制系统(包括Git、Bazaar、Mercurial等)中推送文档更新。

作为程序员如何书写技术文档?

按自己的喜好去写,没有具体的格式,不过要写名程序的用途,代码的函数使用方法,变量的意义等内容

(责任编辑:IT教学网)

更多

推荐杀毒防毒文章