傻强

岂是池鱼恋旧渊,敢比雄鹰上九天。
轻酌小唱性情酣,宏图霸业谈笑间。

导航

技术性论述应该简洁明了


    经常在各技术论坛发贴回帖辩论,发现现在技术人员的文章有个趋势----又臭又长且没有条理性,而这种回复往往把人搞得云里雾里,再者所谓言多必失,说得 多了必然有说错的,后面就有人抓住这些讨伐起来,最后 回帖都扯到十万八千里以外了。

    技术性的帖子或是回帖之类的论述应该是简单明了的。提出自己的想法,然后列举支持这个想法的依据,最好再举个浅显易懂的例子。不同意别人的想法,先指出不 同意什么,然后提出自己的论点。这些都是小学里学过的议论文的写法啊。而现在论坛上混得的技术人员我看要么是词不达意的文盲半文盲,要么就是动辄千言的散 文家或是批判家。我在技术论坛上的回复一般都是尽量简洁,能说明问题就行,很多时候就一句话.但是这样做的缺点是不完善,很容易被不注意语境只注意语言表 面的人反驳。

    所以,我们不妨学学官样文章,自己的论述最好有个一二三四,每一点都有个综述性的句子开头。


题外话:关于技术书籍
    说到这个问题想起了国内和国外的技术书籍出版,外国的大师们(可惜,计算机的大师一般都是外国人)的文风是简单实用,只要能讲清楚问题,越简单越好。像 《设计模式》、《UML精髓》、《有效用例模式》等讲述思想的书,都是薄薄的一本却值得你反复品味,而中国人写的书,仿佛不厚就不能称其为著作, 《Java与模式》1024页,真是厚不惊人誓不休。究其原因,想起前一段看的某老外写的书(具体哪一本忘了)的前言,说是书写完后又用了一段时间的把近 一半的内容缩减了,把那些读者很容易找到的内容(如基本知识)、和书要讲的核心内容有点差距的,作者觉得都不适合放在这本书里的内容全给砍了。反观国内的 技术书籍,也是前几天,买了本写某行业信息系统的书,300多页,只有60页和该行业有关,其他的部分可以叫做《计算机导论》,连互联网7层协议都编进去 了。我想这位作者写书时先是写好提纲,然后死命往里面抄内容吧,只要沾边就行,谁不希望自己的书是大部头呢,页数要上去。

posted on 2005-08-22 04:07  傻强  阅读(396)  评论(0编辑  收藏  举报