写点什么

一篇好的技术文章应该是啥样子的

  • 2013-08-13
  • 本文字数:1134 字

    阅读完需:约 4 分钟

一直以来,InfoQ 中文站在国内的技术社区当中所处的位置还是比较独特的:说是媒体,内容运营的方式却似社区;说是网站,内容审核的流程标准却往杂志、图书出版靠拢。

今天早上在跟 InfoQ 的领域编辑评估一篇投稿,经验分享类的,领域编辑反馈的修改意见较多,基本上整个文章都要重新调整,作者就问我们,是不是会有自己想要反馈给读者的内容不符合 InfoQ 网站定位的问题。我的回复是:

就这篇文章的题材而言,InfoQ 的原则是

1、内容不能炒冷饭,如果前人研究过的,就不用再折腾

2、实践类内容不能引人走弯路。我们要确保传递信息的作者本身对相关方案的优劣都已经分析过,在他所在的情景下,即使选择的不是最优方案,也要是一个相对优化的方案,而不是 work 了,run 起来的方案就行。

我相信你们在实施方案的时候,肯定做过各种方面的权衡。我们作为编辑要做的,是引导你们把这个权衡的过程也暴露出来,好让读者明白,为什么你们会这么做,这么做相对其他方案有啥好处:)

同时,这也意味着,如果你作为作者无法 convince 编辑,让编辑认为你这样做是一种最佳实践,那读者就更难买账啦。

其实仔细想想,这两条说起来虽然简单,但真要做到,其实并不容易。要想不炒冷饭,先要知道前人都炒过些什么饭,这些饭都是啥味道;想要提醒读者哪些是弯路,往往是自己先走过很多弯路,即使有的公司里有很多“前人踩过的那些坑”的文档记录,但很多时候,绕坑前行的能力还是要靠大量的实战积累。

下面分享一下 InfoQ 深度文章的择选标准,如果大家对给 InfoQ 投稿感兴趣,可以做个参考(投稿信箱是 editors@cn.infoq.com )。

对于比较成熟的技术,如 Java、.NET 等,在内容深度上需要达到细分领域的极致。

对于比较新鲜的技术,如新的语言、框架、工具等,作者对新技术的了解程度需要超越大部分业内人士。

对于比较成熟的概念,如敏捷开发、DevOps,需要有实际的经验分享。经验分享类文章需求见下两条。

对于项目经验分享,项目本身需要足够成熟,即,较稳定的运转了足够长的时间,权衡过各种方案的适用性。

对于流程、团队管理类经验分享,团队 / 团队成员本身需要足够成熟,即,踩过很多坑并知道如何绕过一些坑。

对于比较新鲜的概念,作者需要是概念发起人或早期实践者,并且在该概念所属的领域有充足的经验,充分了解新概念与旧概念之间的差异。

对于好的技术内容这个话题,可以讨论的东西还是挺多的,比如什么样的技术算是成熟了,怎样的新技术、新概念看起来像是有发展前景的,怎样的实践算是最佳实践(这在团队管理这样的领域尤其难以评估),等等。这些问题虽然没有绝对的标准答案,不过也不是完全无迹可寻,还是有些经验可以说的。以后有机会,慢慢跟大家分享:)

本日作者简介

杨赛(@lazycai),InfoQ 中文站编辑。到处串门的互联网信徒,相信规则的力量。

2013-08-13 04:25614

评论

发布
暂无评论
发现更多内容

JDK的前世今生:细数 Java5 - 15 的那些经典特性,java高级程序员的要求

Java 程序员 后端

Jenkins用户权限管理-Role-based Authorization Strategy插件

Java 程序员 后端

JPA基本使用,Java虚拟机学习集锦是我攒来的

Java 程序员 后端

JWT单点登录,小甲鱼数据结构百度云

Java 程序员 后端

Java面试题原理和底层,java面试突击第二季

Java 程序员 后端

Java面试题总结(乱序版,2020-08-20,面试总结+详细解答

Java 程序员 后端

JVM性能优化(四)提高网站访问性能之Tomcat优化,java程序开发实用教程邱加永答案

Java 程序员 后端

JVM探究:全面解析OOM异常,都在这了,mysql数据库基础与实例教程孔祥盛

Java 程序员 后端

jvm运行时内存是怎么分布的?,java多线程编程技术第二版下载

Java 程序员 后端

kafka扫盲——别等面试官一问三不知了,linux操作系统教程

Java 程序员 后端

Java高级特性——注解,kafka消息队列的实现原理

Java 程序员 后端

JMX客户端及对commons-pool的监控,java工程师面试视频

Java 程序员 后端

Json的FastJson与Jackson,java阻塞队列原理

Java 程序员 后端

Java面试通关要点汇总集,开发者必备的顶级Java开发工具

Java 程序员 后端

JDK新特性——Stream代码简洁之道,spring视频教程在线观看

Java 程序员 后端

JVM 内存模型,百度笔试题百度校招面试经验

Java 程序员 后端

JVM性能优化(三)G1垃圾收集器(1),java原理书籍

Java 程序员 后端

Java面试题整理《基础篇》,java面试宝典pdf百度云

Java 程序员 后端

Jib使用小结(Maven插件版),Java程序员面试必备的知识点

Java 程序员 后端

JNI开发之方法签名与Java通信(二),mongodb入门篇

Java 程序员 后端

JSP 标准标签库(JSTL),javaee教程视频

Java 程序员 后端

JVM总体概述,java高级编程内容

Java 程序员 后端

Kafka-探险---生产者源码分析---核心组件,Java数据库题目大全

Java 程序员 后端

Jenkins集群下的pipeline实战,kalilinux使用教程pdf

Java 程序员 后端

JSP、EL表达式、JSTL标签,rabbitmq源码分析持久化

Java 程序员 后端

JVM--运行时数据区与内存模型,java开发基础知识点

Java 程序员 后端

JVM类加载你真的【了解】了吗,java项目面试题

Java 程序员 后端

Kafka 的 replica 同步机制(ISR与OSR列表数据相互转换)

Java 程序员 后端

JVM性能优化(三)G1垃圾收集器,附大厂真题面经

Java 程序员 后端

JVM的YGC,这次被它搞惨了!,rabbitmq实战指南pdf最新版

Java 程序员 后端

JVM类加载你真的【了解】了吗(1),网易的朋友给我这份339页的Java面经

Java 程序员 后端

一篇好的技术文章应该是啥样子的_语言 & 开发_sai_InfoQ精选文章