【实战】分享一个花了 499 学到的写作方法:问题 + 回答

简介: 我发现这个方法跟我有一些文章的方法很像,但是我并没有这样总结出来,而是在写的时候自然而然就这么去设计了。

大家好,我是桃翁,一个不止前端的前端工程师。


前言


前几天在一个写作课里学习到一个写作技巧:文章 = 问题 + 答案。


大概就是说当你看到一个话题,想写成文章的时候,可以想一想你针对这个话题会有哪些问题。然后挨个回答一下这个问题,把回答组合一下,就成为一篇文章了


我发现这个方法跟我有一些文章的方法很像,但是我并没有这样总结出来,而是在写的时候自然而然就这么去设计了。


以这篇用 husky 和 lint-staged 构建代码检查工作流 文章举个例,做一个实战教学,建议看下面的内容的时候先阅读一下这篇文章。


实战


一、提问题


我要介绍的主题是:构建代码检查工作流


针对这个主题,我想到了几个问题:


  1. 什么是代码检查?


  1. 什么情况下需要用到代码检查?


  1. 怎么做代码检查?


  1. 怎么把代码检查做成工作流?


注意:每个人想到的问题不一样,所以写的思路可能也不太一样。

如果想不到什么问题,我这里给到的建议可以提 what、when、why、how 这样的问题,这也是一种写作方法,后面再讲。


根据以上的思路就可以把大纲列出来。


二、列大纲


其实一般可以直接把这些问题当做大纲。


但是我这篇文章后面又考虑到怎么做代码检查东西比较多,只有在知道了最基础的代码检查方法之后,才可能推出要用 husky 和 lint-staged 这样的工具。


所以我最终还是以陈述的方式为大纲,一步一步的引导,最终把把代码检查做成工作流。

所以最终这篇文章的目录大概是这样的。


640 (7).png


前言里面回答了什么是代码检查什么情况下需要用到代码检查


在最简单的方法这个大纲里就是怎么做代码检查


最后的三个都是讲怎么把代码检查做成工作流。


三、回答问题


大纲做好了,就开始填内容了。


前言就没什么好说的了,主要是介绍背景,然后引出我们怎么做代码检查。


接下来就写了最简单的方法来做代码检查,再提出了两个问题


640 (8).png


其实这两个问题就是来解决工作流的问题。


下面的两个段落就是来解决这两个问题,看到没有,这又是问题 + 回答的模式,不仅大话题可以引发问题,还可以问题里套问题。


标题:通过 scripts 来解决如果检测工具多,需要多次处理,解决问题 1.


标题:通过 husky(哈士奇)来解决容易遗忘的问题,解决问题 2.


所以整篇文章都是以问题驱动,一步一步引导读者把小问题解决了,最终串起来就把大问题解决了。


总结


总结一下,这种问题 + 回答的写作方式有什么好处:


  1. **段落之间具有连贯性。**每个标题之前都是承上启下,都是来解决上面一个标题的问题,然后引出下面一个问题。


  1. 读者读起来很流畅,会产生恍然大悟的感觉。


最后再复盘一下这篇用 husky 和 lint-staged 构建代码检查工作流 我觉得不好的地方:


  1. 标题不够小白,导致受众不够多导致打开率低。


  1. 在前言里背景介绍得不够细致,如果以前没做过这方面的,可能体感不强。
目录
相关文章
|
XML JSON 前端开发
Spring之RequestBody的使用姿势小结
SpringMVC中处理请求参数有好几种不同的方式,如我们常见的下面几种 根据 HttpServletRequest 对象获取 根据 @PathVariable 注解获取url参数 根据 @RequestParam 注解获取请求参数 根据Bean的方式获取请求参数 根据 @ModelAttribute 注解获取请求参数
916 0
Spring之RequestBody的使用姿势小结
|
2天前
|
数据采集 人工智能 安全
|
11天前
|
云安全 监控 安全
|
3天前
|
自然语言处理 API
万相 Wan2.6 全新升级发布!人人都能当导演的时代来了
通义万相2.6全新升级,支持文生图、图生视频、文生视频,打造电影级创作体验。智能分镜、角色扮演、音画同步,让创意一键成片,大众也能轻松制作高质量短视频。
1007 151
|
3天前
|
编解码 人工智能 机器人
通义万相2.6,模型使用指南
智能分镜 | 多镜头叙事 | 支持15秒视频生成 | 高品质声音生成 | 多人稳定对话
|
16天前
|
机器学习/深度学习 人工智能 自然语言处理
Z-Image:冲击体验上限的下一代图像生成模型
通义实验室推出全新文生图模型Z-Image,以6B参数实现“快、稳、轻、准”突破。Turbo版本仅需8步亚秒级生成,支持16GB显存设备,中英双语理解与文字渲染尤为出色,真实感和美学表现媲美国际顶尖模型,被誉为“最值得关注的开源生图模型之一”。
1701 9
|
8天前
|
人工智能 自然语言处理 API
一句话生成拓扑图!AI+Draw.io 封神开源组合,工具让你的效率爆炸
一句话生成拓扑图!next-ai-draw-io 结合 AI 与 Draw.io,通过自然语言秒出架构图,支持私有部署、免费大模型接口,彻底解放生产力,绘图效率直接爆炸。
644 152
|
10天前
|
人工智能 安全 前端开发
AgentScope Java v1.0 发布,让 Java 开发者轻松构建企业级 Agentic 应用
AgentScope 重磅发布 Java 版本,拥抱企业开发主流技术栈。
613 12