2019 年,思否成立了编辑部,技术编辑通过撰写技术资讯的方式服务社区开发者,让大家通过思否了解到全球第一手的技术资讯。
在组建编辑部门、面试候选人和编辑部日常会议中,我常常思考怎样可以帮助技术背景的同事写出好文章,怎样帮助编辑背景的同事更快了解技术行业,怎样做好内部培训、并通过技术编辑赋能社区技术作者……
今天从 “如何写出好文章” 入手分享一些个人关于技术资讯类写作的零散经验。
写什么
- 善找来源:海外媒体,相关领域 KOL 的 Twitter、微博、朋友圈,关注第一手消息来源
- 善用工具:DeepL,微信体系内的文章搜索,Google 搜索
好文章的标准
逻辑清晰,观点鲜明,内容充实,表述准确,能够让目标读者快速 GET 到你传递的信息,并有所收获。
快速写作三步走
- 素材搜集:查找资料,并将素材罗列在一个文档内
- 草拟提纲:通读文档,根据素材快速草拟提纲(一篇文章的几个小标题),并把文档中的内容填入几个小标题下
- 用心雕琢:完善加工几个小标题下的内容
环节 1 决定了你文章的丰满程度,全面的素材采集也有助于你个人观点的形成;
环节 2 决定了全文的结构和不同段落间的逻辑关联,梳理清楚可以帮助你的读者更高效获取文章信息。
这两个步骤应尽量一气呵成,短时间内集中梳理思路,形成文章结构。进入第三个环节再“慢工出细活”,推敲具体字句。
如何增强文章的可读性,让文章更“干”?
- 善于引用数据:数据是最准确的表达方式,尤其是技术方向的文章,模糊的感性表达远不如清晰的数据陈列;
- 善于通过图表将复杂的数据和逻辑“可视化”:当数据相对复杂、多元时,应尽量用可视化的方式表现,更简洁、清晰,也可以让读者发现不同数据间的联系;
- 有同理心,会换位思考,善于使用通俗易懂的比喻手法,用目标受众所在领域更熟悉的知识去表达观点;
- 不同级别的标题和目录有利于帮助读者快速 GET 文章结构和核心观点,目前绝大多数文档工具(包括 SegmentFault 的文章编辑器)都会根据各级标题自动生成目录,应利用好相关工具;
- 术语解释:对于存在理解难度的专业术语,应进行简要解释。
自己不熟悉的领域如何产出“原创观点”?
捕捉热点事件时,需要加入一些独家内容或原创观点,才能让你的文章“与众不同”,为读者创造价值。如果你是这个行业的专家,那么不妨大胆陈述自己的观点。
如果恰恰是自己并不擅长的领域,也有两个办法为你的文章锦上添花:
- 采访当事人或相关人
举例:在 首位中国人!吴晟当选 Apache 软件基金会新一任董事 一文中,采访了吴晟本人和曾与其共事的行业专家适兕,让一篇素材并不充分的短讯,内容更加丰满。 - 采访行业 KOL 或引用 KOL 观点
举例:在 开源十问, 社区新人快速上手指南 一文中,引用了数位行业 KOL 的观点,让文章干货满满,可信度提升
给你的文章一个吸引人的标题
在很多发文渠道中(如 SegmentFault 思否社区、微信公众号),缩略图和标题是决定读者是否选择阅读全文的唯一因素,因此标题至关重要。
好标题 ≠ 标题党。比如在思否社区上,大家以学习交流技术为目标,UC 震惊体的标题可能不仅不会引起关注还会让读者反感。因此起标题主要要考虑受众,面向技术群体,在标题中简明扼要提炼文章主旨,适当保留神秘感即可。
要习惯于朗读自己写的文章(重要)
朗读(读出声来,而非默读)是检查错别字、语句通顺等问题的最佳方式。
朗读的过程也是 review 全文的过程,主旨是否清晰?段落结构是否合理?表达方式和目标受众的阅读习惯是否匹配等。
此外,阅读体验好的文章,也一定是“可朗读”的,朗朗上口、表达得体、通俗易懂。
关于文档排版规范
建议参考: https://open.leancloud.cn/cop...
关注细节,注意中英文空格、标点符号正确等细小问题。
尊重原创
引用他人观点,借鉴他人文章记得注明出处,同为内容创作者,尊重他人原创就是尊重自己的劳动成果。
思否社区鼓励大家撰写或翻译优质的原创技术文章,欢迎大家积极在社区贡献,好的文章我们会推荐到社区首页,并 SegmentFault 公众号求转载。
投稿 or 求推荐可添加思否小姐姐(微信号:sifou1024),一些零散的写作经验分享,希望对你有所帮助,快在社区开启你的技术分享之旅吧!
关于作者:江波,连续创业者,SegmentFault 思否 COO,前 Insta360 运营负责人。高中时期开始在《凤凰周刊》杂志社实习,大学时期曾先后在《南方都市报》、广东广播电视台实习,任实习记者、编导、制片人助理等,多篇文章在南方都市报、中国财富杂志、北京青年报发表。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。