工作随手一记 - 做出来的给4000,写出来的给6000
来源:互联网 发布:淘宝店铺首页宽屏代码 编辑:程序博客网 时间:2024/06/04 04:48
当然,标题中的4000和6000,只是一个示意。
文档,似乎真的是搞技术的一大软肋。
最近在从ant迁移到maven,安排一同事编写两份文档:一个是迁移步骤step by step;另一个是MAVEN的入门教程。教程还好说,基本上用PPT顺下来,介绍基本概念和用法即可。而迁移步骤这份文档,我前后安排三个人按照文档进行演练,然后让他根据演练过程中遇到的问题对文档进行修正,以期达到对照文档,各个模块的负责人可以基本完成迁移的目的。修改了四遍,其实主要的内容已经写的很清楚了,可总觉的顺下来缺了点什么,最后我还是忍不住帮助做了最终的完善,其实没加什么东西,主要就是:
1、承上启下的衔接句。
2、对假设条件的显式声明,比如:假如MAVEN的安装路径为XXXX。否则,读者很难理解settings.xml在什么位置。
3、增加交叉引用。比如:pom中的ArtifactId,应该填写xxxx,具体参见1.2节的协商结果。
4、对于感觉文字不易描述清楚的地方,增加获取进一步帮助的途径。比如:提交CVS的路径,需要根据模块的groupid和artifactId以及模块之间的继承关系共同确定,如果无法确认自己应提交的路径,请与XX联系。
每次开会问开发人员,你的目标是什么,大家都会回答:先提高技术,然后做设计,做项目经理。总之,没有人自甘落后,至少我还没有听到有人这么说过。如果再追问:怎么取得进步?很多人会回答:要提高分析问题的能力,也有人回答:要把技术做强做透。
然而,在接下来的日常工作中,很多人并没有把在做的事情当作一个实践理想的机会。反正在我所接触的大部分人里,要求他们抛开编程语言分析问题,比如写文档,似乎是一件很为难的事情。我如果说:你把今天咱们讨论的想法细化一下,整理一个文档出来。那么我往往得到的是一个寥寥数言的notes,并没有在我们谈话之外太多的内容,更像是会议纪要。但如果我说:你接下来把这个想法细化一下吧。我往往很快会得到一个demo,这个demo里的确有很多值得探讨的想法。
虽然通过demo来验证一些想法挺好,但如果面对的是一个大系统,不可能方方面面都先demo了再细化。写文档的难度,其实还是反应了分析问题的能力欠缺,然而,越是这方面欠缺,越应该在实践中弥补,而不是回避文档。美好理想与日常工作无法统一,是一个很矛盾的现象。
如果有这样一项规定:会做demo的给4K/月,会写文档的给6K/月,是不是能够扭转这个局面呢?
- 工作随手一记 - 做出来的给4000,写出来的给6000
- 最近工作笔试 没做出来的。。。
- 随手抄来的
- 联想利泰的一道做出来就给月薪7K的面试题--交通灯管理系统
- 联想利泰的一道做出来就给月薪7K的面试题--交通灯管理系统
- 联想利泰的一道做出来就给月薪7K的面试题--交通灯管理系统
- jquery做出来的东东
- “给力”是怎么得来的?
- - - 谁把这老贴给翻出来的。。
- 给自考来个温暖的提醒
- 最好是用C语言可以写出来的 代码不用给了 说出意思就行 日历(万年历)算法
- JavaScript实现动态时钟,自己刚写出来的希望能给您带来帮助,逻辑有待精简,欢迎评价
- 想学编程语言接外包,懂行的 人指点了几句 写出来给大家参考下
- 给来深圳找程序员工作的你的几个忠告
- 来深圳,已经快一月,谁有pb的工作,给介绍一个,谢谢了!!
- 程序是写出来的
- 精神病,是自己做出来的
- 现代处理器是怎么做出来的?
- 子窗口和父窗口的函数或对象能否相互访问
- DBMS_STATS.GATHER_TABLE_STATS详解
- 不管做什么累了,就来看看这些
- Android开发手记1--环境配置
- 求c# 方面关于tcp/udp的教材
- 工作随手一记 - 做出来的给4000,写出来的给6000
- 判断手机和电脑是否同步 windows mobile
- ========================
- 图论学习中(1)
- sql server 转 access 笔记
- ACE主要应用框架与类别(一):ACE的框架结构
- Varnish 应用技术指南 V2.2
- Linux牛人的博客开张
- SVN1.6.3 教程 搭建服务器及myeclipse客户端使用