重庆分公司,新征程启航

为企业提供网站建设、域名注册、服务器等服务

IT技术写作技巧分享:慎用术语和概念-创新互联

在技术本身不断升级扩展的过程中,会引进各种各样的新思想,例如在Java领域里,面向对象、面向切面、微服务、依赖注入等都是在技术发展的不同阶段,出现的新概念。

创新互联是一家专业提供东宝企业网站建设,专注与做网站、网站制作H5高端网站建设、小程序制作等业务。10年已为东宝众多企业、政府机构等服务。创新互联专业网站制作公司优惠进行中。

一本通俗易懂的书应该按照由浅入深的顺序来展开知识体系。作者要对文中的概念、术语保持高度的敏感。在每句话中提及一个概念时,都要考虑以下问题:
(1)对于本书的读者群,这是众所周知的简单概念吗?如果是,就无需解释。例如对于Java编程的书,读者肯定对“操作系统”具备了一些常识,就没有必要对此解释。
(2)对于复杂的概念,这是在书中第一次出现吗?如果是第一次出现,就要加以解释。如果在本节不适合重点阐述此概念,那应该提供相关的参照信息。在此处对此概念稍加解释,再让读者到XXX章XXX节对此概念获得更详细的了解。

例如假定在介绍Java流程控制的一章的范例中涉及到异常,此时对异常稍加解释,然后给出参考信息:关于异常的详细概念请参考本书第X章。

(3)在解释一个概念的时候,切忌用一个深奥的概念去解释另一个概念。这样会让读者看了之后不知所云,无法继续深入学习。

下面分析网上的一段介绍“Spring Cloud”的文字:


Spring Cloud 是什么?

Spring Cloud 是一系列框架的有序集合,它利用 Spring Boot 的开发便利性简化了分布式系统的开发,比如服务发现、服务网关、服务路由、链路追踪等。Spring Cloud 并不重复造轮子,而是将市面上开发得比较好的模块集成进去,进行封装,从而减少了各模块的开发成本。换句话说:Spring Cloud 提供了构建分布式系统所需的“全家桶”。

以上这段文字中涉及到“一系列框架”、“Spring Boot”、“分布式系统”、“服务”、“服务发现”、“服务网关”、“服务路由”、“链路追踪”、“造轮子”、“全家桶”等词汇或术语。

对于已经在分布式领域有开发基础的读者来说,他们对这段文字会比较容易理解。如果这段文字是面向开发分布式系统的新手,他可能对许多概念都一无所知。这时候,即使读了这段文字,对Spring Cloud的认识还是模模糊糊。如果要让小白们理解Spring Cloud。就需要先介绍一些背景知识,扫清读者对基本知识的障碍,然后再引出Spring Cloud的解释。

文中的“造轮子”、“全家桶”是一些流行语,它们往往在某个时期很流行,过一阵又销声匿迹。对于业界人士会熟悉这些流行语,而入门人士未必听说过这些流行语,需要费力地去猜测它的意思。把文中的“重复造轮子”改为“重复编写额外的框架”,“全家桶”改为“集成框架体系”,这样会更一目了然。

总的说来,当作者在写书时,首先要定位好读者群。接着写书的时候,要一直设想自己是面对面地和读者交流,站在读者的角度去思考,这段话对方看得懂吗?如果看不懂,就要采用以下方式让读者看懂:
(1)换一种措辞更简单的说法。
(2)对其中的术语、概念进行解释,并切忌用更晦涩的概念去解释当前概念。
(3)结合典型的范例和形象的图片来阐述当前的语句。

孙卫琴
经典畅销书籍《Java面向对象编程》、《Tomcat与Java Web开发技术详解》等的作者

另外有需要云服务器可以了解下创新互联scvps.cn,海内外云服务器15元起步,三天无理由+7*72小时售后在线,公司持有idc许可证,提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案,具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势,专为企业上云打造定制,能够满足用户丰富、多元化的应用场景需求。


分享文章:IT技术写作技巧分享:慎用术语和概念-创新互联
转载来于:http://cqcxhl.cn/article/ccisjd.html

其他资讯

在线咨询
服务热线
服务热线:028-86922220
TOP