(八)写文档的一些感想
2014-09-08 01:00
246 查看
代码的工作完成以后感觉博客要写什么实在不好把握,最近都在写文档,那么我就说说写文档的一些感受吧。
在学校也要写文档,不过一般都是以报告的形式,这次的文档主要是介绍如何将OData插件整合到SugarCRM中,所以偏向于指导性的文档。自己在完成这次项目的过程中也是阅读了许多文档,所以在读别人文档时自己感受到的一些不好的地方就需要借鉴和改进。比如有的时候看到别人的文档写修改某个设置的时候没有提到不同环境下怎么修改,于是自己在写的时候就会注意,尽量将不同环境下的设置都讲清楚。又比如一些专业单词的使用要注意普遍化和专业化,既不能太过通俗,又不能说的别人根本不懂是什么意思。
另外,我觉得写这次的文档就是要告诉别人怎么做,所以要将一些关键点讲清楚,讲明白,重复工作量的地方该略过的就略过,言简意赅要格外注意。
其实代码写的好是一方面,另一方面就是文档写的清晰明了,读起来顺畅通顺。这是第一次写这类的文档,我想以后会写的更好一些。
在学校也要写文档,不过一般都是以报告的形式,这次的文档主要是介绍如何将OData插件整合到SugarCRM中,所以偏向于指导性的文档。自己在完成这次项目的过程中也是阅读了许多文档,所以在读别人文档时自己感受到的一些不好的地方就需要借鉴和改进。比如有的时候看到别人的文档写修改某个设置的时候没有提到不同环境下怎么修改,于是自己在写的时候就会注意,尽量将不同环境下的设置都讲清楚。又比如一些专业单词的使用要注意普遍化和专业化,既不能太过通俗,又不能说的别人根本不懂是什么意思。
另外,我觉得写这次的文档就是要告诉别人怎么做,所以要将一些关键点讲清楚,讲明白,重复工作量的地方该略过的就略过,言简意赅要格外注意。
其实代码写的好是一方面,另一方面就是文档写的清晰明了,读起来顺畅通顺。这是第一次写这类的文档,我想以后会写的更好一些。
相关文章推荐
- 参加51CTO技术沙龙后的一些感想 推荐
- 关于开通博客的一些感想
- [转]最新版Componentart Web.UI控件来说CA控件的授权实现以及一些感想
- apple开发者文档关于KVC和KVO文档的一些渣翻——这里是原地址
- 在华为做外包获得的一些感想
- 一些文档生成工具
- 一些感想
- 奇异值矩阵分解(Singular Value Decomposition)的一些感想
- 生成 RSS2.0 文档可能犯错误的一些地方
- Castle.ActiveRecord 讲演的PPT以及一些感想
- 一些不错的文档网址--笔记【原创】
- 一些关于工作的感想
- “采用while(!feof(FP)){...}进行文件复制时,目标文档总会比源文档多出一些” 原因探析及解决方法
- 计算素数算法的一些优化(编程珠玑阅读感想)
- .NET的一点历史故事:作者的一些感想
- 关于这几天学爬视频链接的一些感想
- 关于java和.net的一些感想
- 关于追女生的一些感想 2
- 生成 RSS2.0 文档可能犯错误的一些地方
- javascript插件开发的一些感想和心得