今天是一个特别的日子,是毕业参加工作第一次受到上司的批评。批评设计文档写得很差,很多内容都没有具体的出处。看完文档还是不知道具体的每个细节
他说很多关于设计及编写方面的内容,总结起来有以下几条原则:
1。设计的原理:首先要想清楚做什么,如何做,怎么做,具体实现应该是什么。只有把整个过程想清楚了,设计出来的东西才能够经得起应用的推敲
2。设计中对于每一个元素都应该有详细的说明,说明每一个元素今后的具体应用场景及如何应用。如果没有想清楚应用场景,最好不要加进去。这样会带来系统的松散及整个架构其差
3。设计的侧重点应当有区别。不能够一把抓,这样到头两手空
4。设计文档中写的每一细节都需要详细考虑设计的过程,不能够随便信口开河。必须要有事实的依据
5。对于设计的重点,为了加深理解需要加些以后实际应用的例子上去
6。设计中涉及到修改以前的功能,需要充分考虑兼容性。不能够随便的乱改一通
7。对于每一个设计方案,都要考虑到其扩展性,优点,缺点
8。文档的作用除了在于记录设计过程中点点滴滴的考虑。最重要的一方面是详细说明的系统的功能及实际细节。它需要达到在没有设计者的帮助下,当事人可以通过仅依靠文档就了解整个
系统的架构及设计细节。是把设计的考虑细节重现给当事人。
大体意思就是以上这几条。虽然平时的时候看一些设计的书籍。也都有涉及到上面的几条。但看完之后没过几天基本上都会忘记掉。基本上是在做无用功。
书本知识没有经过具体的实践应用是很容易忘记的,只有在实践当中才能够加深对知识的理解。
听完之后感慨颇多。觉得虽然他说的很有道理是从业将近10年的心得,但是不应该如此严厉的批评于我。或许这就是本人劣根性的体现吧。人在一件事情的处理原则,对待别人总是会比较严厉,
对待自己总是会比较宽松。
总的来讲,这次批评给自己上了一堂很深刻的课程。让自己认识到在设计方面及文档编写方面的存在着不足。需要在今后的工作中加深这方面的学习。同时也让自己认识到性格上面存在一点劣根性,有着阿Q精神。虽然这种劣根性在保护自己方面可以起到
一定的作用。但从另外一方面来讲是给自己找了一个逃避的借口。需要正视这种劣根性的作用。