热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

技术性论述应该简洁明了

经常在各技术论坛发贴回帖辩论,发现现在技术人员的文章有个趋势----又臭又长且没有条理性,而这种回复往往把人搞得云里雾里,再者所谓言多必失

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

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

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


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

转:https://www.cnblogs.com/fusali/archive/2005/08/22/219889.html



推荐阅读
  • 结城浩(1963年7月出生),日本资深程序员和技术作家,居住在东京武藏野市。他开发了著名的YukiWiki软件,并在杂志上发表了大量程序入门文章和技术翻译作品。结城浩著有30多本关于编程和数学的书籍,其中许多被翻译成英文和韩文。 ... [详细]
  • 探索Web 2.0新概念:Widget
    尽管你可能尚未注意到Widget,但正如几年前对RSS的陌生一样,这一概念正逐渐走入大众视野。据美国某权威杂志预测,2007年将是Widget年。本文将详细介绍Widget的定义、功能及其未来发展趋势。 ... [详细]
  • javascript分页类支持页码格式
    前端时间因为项目需要,要对一个产品下所有的附属图片进行分页显示,没考虑ajax一张张请求,所以干脆一次性全部把图片out,然 ... [详细]
  • 优化虎牙直播体验的插件
    近期在观看虎牙直播时,发现广告和一些低质量直播间频繁出现,严重影响了观看体验。为此,我开发了一款插件,帮助用户屏蔽这些不想要的内容。以下是插件的介绍和使用方法。 ... [详细]
  • 本文详细介绍了 HTML 中 a 标签的 href 属性的多种用法,包括实现超链接、锚点以及调用 JavaScript 方法。通过具体的示例和解释,帮助开发者更好地理解和应用这些技术。 ... [详细]
  • 本文介绍了一种使用 JavaScript 计算两个日期之间时间差的方法。该方法支持多种时间格式,并能返回秒、分钟、小时和天数等不同精度的时间差。 ... [详细]
  • 字符串学习时间:1.5W(“W”周,下同)知识点checkliststrlen()函数的返回值是什么类型的?字 ... [详细]
  • 本文详细介绍了 ASP.NET 中用于文件上传的控件及其使用方法,包括常见的 FileUpload 控件和其他相关技术。 ... [详细]
  • 本文介绍了一种在ANSI C中动态分配二维数组的方法。通过创建指针数组并为每个指针分配连续空间,可以灵活地管理内存。文章还讨论了一些常见的错误和注意事项。 ... [详细]
  • `valueOf` 方法(即 `Object.valueOf`)用于返回指定对象的原始值。如果该对象没有对应的基元值,则直接返回对象本身。此方法在需要将对象转换为基本类型时非常有用,例如在数值运算或字符串拼接等场景中。通过深入了解 `valueOf` 的工作原理及其应用场景,开发者可以更好地处理数据类型转换问题,提高代码的健壮性和可读性。 ... [详细]
  • PTArchiver工作原理详解与应用分析
    PTArchiver工作原理及其应用分析本文详细解析了PTArchiver的工作机制,探讨了其在数据归档和管理中的应用。PTArchiver通过高效的压缩算法和灵活的存储策略,实现了对大规模数据的高效管理和长期保存。文章还介绍了其在企业级数据备份、历史数据迁移等场景中的实际应用案例,为用户提供了实用的操作建议和技术支持。 ... [详细]
  • 春日新芽象征着新的开始,正如学习如同春天的幼苗,虽不易察觉其成长,但每日都在进步;而中断学习则像磨刀石,虽表面无明显损耗,却日积月累地退步。这番话源自古代文人陶渊明的智慧,提醒我们珍惜时光,持续努力,方能迎来更加辉煌的未来。 ... [详细]
  • Cocos2d-x 正式开启游戏开发的新篇章,为开发者提供了全新的起点。作为一款跨平台的游戏引擎,Cocos2d-x 不仅支持多种操作系统,还具备强大的图形渲染能力和高效的性能优化,使得游戏开发变得更加便捷和高效。无论是初学者还是经验丰富的开发者,都能在 Cocos2d-x 的支持下,轻松实现创意,打造高质量的游戏作品。 ... [详细]
  • 本文详细介绍了批处理技术的基本概念及其在实际应用中的重要性。首先,对简单的批处理内部命令进行了概述,重点讲解了Echo命令的功能,包括如何打开或关闭回显功能以及显示消息。如果没有指定任何参数,Echo命令会显示当前的回显设置。此外,文章还探讨了批处理技术在自动化任务执行、系统管理等领域的广泛应用,为读者提供了丰富的实践案例和技术指导。 ... [详细]
  • Eclipse项目重新编译指南:提升开发效率的关键步骤
    在Eclipse中,可以通过以下步骤来提高项目的编译效率:首先,在“Project”菜单中选择“Clean”选项,然后在弹出的对话框中选择需要清理的项目,并点击“OK”。完成清理后,重新运行或调试项目以确保代码的最新状态。此外,定期清理项目有助于消除编译错误和缓存问题,从而提升开发体验。 ... [详细]
author-avatar
蓝雪帝国666
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有