关于技术资讯写作的零散经验分享

波波Nadia
English

2019 年,思否成立了编辑部,技术编辑通过撰写技术资讯的方式服务社区开发者,让大家通过思否了解到全球第一手的技术资讯。

在组建编辑部门、面试候选人和编辑部日常会议中,我常常思考怎样可以帮助技术背景的同事写出好文章,怎样帮助编辑背景的同事更快了解技术行业,怎样做好内部培训、并通过技术编辑赋能社区技术作者……

今天从 “如何写出好文章” 入手分享一些个人关于技术资讯类写作的零散经验。

写什么

  • 善找来源:海外媒体,相关领域 KOL 的 Twitter、微博、朋友圈,关注第一手消息来源
  • 善用工具:DeepL,微信体系内的文章搜索,Google 搜索

好文章的标准

逻辑清晰,观点鲜明,内容充实,表述准确,能够让目标读者快速 GET 到你传递的信息,并有所收获。

快速写作三步走

  • 素材搜集:查找资料,并将素材罗列在一个文档内
  • 草拟提纲:通读文档,根据素材快速草拟提纲(一篇文章的几个小标题),并把文档中的内容填入几个小标题下
  • 用心雕琢:完善加工几个小标题下的内容

环节 1 决定了你文章的丰满程度,全面的素材采集也有助于你个人观点的形成;

环节 2 决定了全文的结构和不同段落间的逻辑关联,梳理清楚可以帮助你的读者更高效获取文章信息。

这两个步骤应尽量一气呵成,短时间内集中梳理思路,形成文章结构。进入第三个环节再“慢工出细活”,推敲具体字句。

如何增强文章的可读性,让文章更“干”?

  • 善于引用数据:数据是最准确的表达方式,尤其是技术方向的文章,模糊的感性表达远不如清晰的数据陈列;
  • 善于通过图表将复杂的数据和逻辑“可视化”:当数据相对复杂、多元时,应尽量用可视化的方式表现,更简洁、清晰,也可以让读者发现不同数据间的联系;
  • 有同理心,会换位思考,善于使用通俗易懂的比喻手法,用目标受众所在领域更熟悉的知识去表达观点
  • 不同级别的标题和目录有利于帮助读者快速 GET 文章结构和核心观点,目前绝大多数文档工具(包括 SegmentFault 的文章编辑器)都会根据各级标题自动生成目录,应利用好相关工具;
  • 术语解释:对于存在理解难度的专业术语,应进行简要解释。

自己不熟悉的领域如何产出“原创观点”?

捕捉热点事件时,需要加入一些独家内容或原创观点,才能让你的文章“与众不同”,为读者创造价值。如果你是这个行业的专家,那么不妨大胆陈述自己的观点。

如果恰恰是自己并不擅长的领域,也有两个办法为你的文章锦上添花:

给你的文章一个吸引人的标题

在很多发文渠道中(如 SegmentFault 思否社区、微信公众号),缩略图和标题是决定读者是否选择阅读全文的唯一因素,因此标题至关重要。

好标题 ≠ 标题党。比如在思否社区上,大家以学习交流技术为目标,UC 震惊体的标题可能不仅不会引起关注还会让读者反感。因此起标题主要要考虑受众,面向技术群体,在标题中简明扼要提炼文章主旨,适当保留神秘感即可。

要习惯于朗读自己写的文章(重要)

朗读(读出声来,而非默读)是检查错别字、语句通顺等问题的最佳方式。

朗读的过程也是 review 全文的过程,主旨是否清晰?段落结构是否合理?表达方式和目标受众的阅读习惯是否匹配等。

此外,阅读体验好的文章,也一定是“可朗读”的,朗朗上口、表达得体、通俗易懂

关于文档排版规范

建议参考: https://open.leancloud.cn/cop...
关注细节,注意中英文空格、标点符号正确等细小问题。

尊重原创

引用他人观点,借鉴他人文章记得注明出处,同为内容创作者,尊重他人原创就是尊重自己的劳动成果。


思否社区鼓励大家撰写或翻译优质的原创技术文章,欢迎大家积极在社区贡献,好的文章我们会推荐到社区首页,并 SegmentFault 公众号求转载。

投稿 or 求推荐可添加思否小姐姐(微信号:sifou1024),一些零散的写作经验分享,希望对你有所帮助,快在社区开启你的技术分享之旅吧!

关于作者:江波,连续创业者,SegmentFault 思否 COO,前 Insta360 运营负责人。高中时期开始在《凤凰周刊》杂志社实习,大学时期曾先后在《南方都市报》、广东广播电视台实习,任实习记者、编导、制片人助理等,多篇文章在南方都市报、中国财富杂志、北京青年报发表。

阅读 979

SegmentFault 社区运营
SegmentFault 思否社区管理官方专栏,在这里发布 SegmentFault 思否社区运营和管理相关的最新消息。
avatar
波波Nadia
SegmentFault 运营合伙人

SegmentFault 思否 COO

457 声望
2.8k 粉丝
0 条评论
你知道吗?

avatar
波波Nadia
SegmentFault 运营合伙人

SegmentFault 思否 COO

457 声望
2.8k 粉丝
宣传栏