工作随手一记 - 做出来的给4000,写出来的给6000
2009-09-08 23:46
211 查看
当然,标题中的4000和6000,只是一个示意。
文档,似乎真的是搞技术的一大软肋。
最近在从ant迁移到maven,安排一同事编写两份文档:一个是迁移步骤step by step;另一个是M***EN的入门教程。教程还好说,基本上用PPT顺下来,介绍基本概念和用法即可。而迁移步骤这份文档,我前后安排三个人按照文档进行演练,然后让他根据演练过程中遇到的问题对文档进行修正,以期达到对照文档,各个模块的负责人可以基本完成迁移的目的。修改了四遍,其实主要的内容已经写的很清楚了,可总觉的顺下来缺了点什么,最后我还是忍不住帮助做了最终的完善,其实没加什么东西,主要就是:
1、承上启下的衔接句。
2、对假设条件的显式声明,比如:假如M***EN的安装路径为XXXX。否则,读者很难理解settings.xml在什么位置。
3、增加交叉引用。比如:pom中的ArtifactId,应该填写xxxx,具体参见1.2节的协商结果。
4、对于感觉文字不易描述清楚的地方,增加获取进一步帮助的途径。比如:提交CVS的路径,需要根据模块的groupid和artifactId以及模块之间的继承关系共同确定,如果无法确认自己应提交的路径,请与XX联系。
每次开会问开发人员,你的目标是什么,大家都会回答:先提高技术,然后做设计,做项目经理。总之,没有人自甘落后,至少我还没有听到有人这么说过。如果再追问:怎么取得进步?很多人会回答:要提高分析问题的能力,也有人回答:要把技术做强做透。
然而,在接下来的日常工作中,很多人并没有把在做的事情当作一个实践理想的机会。反正在我所接触的大部分人里,要求他们抛开编程语言分析问题,比如写文档,似乎是一件很为难的事情。我如果说:你把今天咱们讨论的想法细化一下,整理一个文档出来。那么我往往得到的是一个寥寥数言的notes,并没有在我们谈话之外太多的内容,更像是会议纪要。但如果我说:你接下来把这个想法细化一下吧。我往往很快会得到一个demo,这个demo里的确有很多值得探讨的想法。
虽然通过demo来验证一些想法挺好,但如果面对的是一个大系统,不可能方方面面都先demo了再细化。写文档的难度,其实还是反应了分析问题的能力欠缺,然而,越是这方面欠缺,越应该在实践中弥补,而不是回避文档。美好理想与日常工作无法统一,是一个很矛盾的现象。
如果有这样一项规定:会做demo的给4K/月,会写文档的给6K/月,是不是能够扭转这个局面呢?
文档,似乎真的是搞技术的一大软肋。
最近在从ant迁移到maven,安排一同事编写两份文档:一个是迁移步骤step by step;另一个是M***EN的入门教程。教程还好说,基本上用PPT顺下来,介绍基本概念和用法即可。而迁移步骤这份文档,我前后安排三个人按照文档进行演练,然后让他根据演练过程中遇到的问题对文档进行修正,以期达到对照文档,各个模块的负责人可以基本完成迁移的目的。修改了四遍,其实主要的内容已经写的很清楚了,可总觉的顺下来缺了点什么,最后我还是忍不住帮助做了最终的完善,其实没加什么东西,主要就是:
1、承上启下的衔接句。
2、对假设条件的显式声明,比如:假如M***EN的安装路径为XXXX。否则,读者很难理解settings.xml在什么位置。
3、增加交叉引用。比如:pom中的ArtifactId,应该填写xxxx,具体参见1.2节的协商结果。
4、对于感觉文字不易描述清楚的地方,增加获取进一步帮助的途径。比如:提交CVS的路径,需要根据模块的groupid和artifactId以及模块之间的继承关系共同确定,如果无法确认自己应提交的路径,请与XX联系。
每次开会问开发人员,你的目标是什么,大家都会回答:先提高技术,然后做设计,做项目经理。总之,没有人自甘落后,至少我还没有听到有人这么说过。如果再追问:怎么取得进步?很多人会回答:要提高分析问题的能力,也有人回答:要把技术做强做透。
然而,在接下来的日常工作中,很多人并没有把在做的事情当作一个实践理想的机会。反正在我所接触的大部分人里,要求他们抛开编程语言分析问题,比如写文档,似乎是一件很为难的事情。我如果说:你把今天咱们讨论的想法细化一下,整理一个文档出来。那么我往往得到的是一个寥寥数言的notes,并没有在我们谈话之外太多的内容,更像是会议纪要。但如果我说:你接下来把这个想法细化一下吧。我往往很快会得到一个demo,这个demo里的确有很多值得探讨的想法。
虽然通过demo来验证一些想法挺好,但如果面对的是一个大系统,不可能方方面面都先demo了再细化。写文档的难度,其实还是反应了分析问题的能力欠缺,然而,越是这方面欠缺,越应该在实践中弥补,而不是回避文档。美好理想与日常工作无法统一,是一个很矛盾的现象。
如果有这样一项规定:会做demo的给4K/月,会写文档的给6K/月,是不是能够扭转这个局面呢?
相关文章推荐
- 工作随手一记 -如何获取信息
- [程序代写推荐]不要说你工作多久,多厉害!这些题不从网上找答案,你能做出来吗???
- 美工作出来的页面都是html格式的~闲来无事~写了个程序用来转换html格式页面为aspx格式,并为之生成cs文件
- [多图]大家看看从微软出来的高级程序员是如何工作和生活的?!
- 最近在找新工作,今天收到这样的一封Email,贴出来让大家看看!
- 随手一记
- 出来工作半年感想
- Ruby随手一记.变量作用域
- 好老的文章了,今天把它挖出来了,其实在整个JAVA的学习中偶然性很多,改变你路线的东西也很多,很多东西是跟着工作的变化而变化的,因此关键在于把其中几个学精通,有个主方向,并要懂灵活变化。真个技术生涯还
- Git.Framework 框架随手记--准备工作
- 想没IT编程没有基础能学吗?学出来能找到工作吗?
- [找程序员代写推荐]不要说你工作多久,多厉害!这些题不从网上找答案,你能做出来吗???
- 刚出来工作的程序员的工作总结
- 求助:将搜索出来的周边信息显示在 4000 界面上
- 用户消费总金额 2000以下 2000-4000 4000-6000 查询连续数字,统计个数
- Catalyst 4000 6000配置经验谈(二)
- 工作是干出来的
- eclipse export出来的jar包不能正常工作 ,调试模式下可以正常运行
- 浏览器工作 4000 原理详解
- 谁出来工作都不容易!