【实战】分享一个花了 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. 在前言里背景介绍得不够细致,如果以前没做过这方面的,可能体感不强。
目录
相关文章
|
4月前
|
机器学习/深度学习 存储 自然语言处理
大模型基础概念术语解释
大语言模型(LLM)基于Transformer架构,通过海量文本训练,具备强大语言理解与生成能力。其核心组件包括注意力机制、位置编码与嵌入层,支持文本分割为Token进行处理。参数量达亿级以上,规模增长带来涌现能力,如复杂推理与跨任务泛化。混合专家模型(MoE)提升效率,推动模型持续扩展。
|
7月前
|
JSON 安全 API
亚马逊支付API:支持国际卡种,开拓跨境用户
亚马逊通过集成支持Visa、Mastercard等国际卡种的支付API,提升跨境交易便捷性。本文详解API调用、卡种识别、实时汇率转换与安全机制,结合代码示例与合规要点,助力开发者高效实现全球化支付,拓展国际市场。
500 0
|
7月前
|
存储 缓存 安全
阿里云企业级云服务器收费标准、选型指南与活动价格参考
2025年租用阿里云企业级云服务器,用户可以选择多种实例类型和配置,以满足不同规模和需求的企业应用。目前在阿里云的活动中提供了包括通用算力型u1、通用型g9i与g8y、计算型c9i与c8y、内存型r9i等在内的多种企业级云服务器实例,例如,通用算力型u1实例2核4G5M带宽80G ESSD Entry云盘特惠价199元1年,计算型c9i实例2核4G活动价为1686.70元/1年起,通用型g9i实例2核8G活动价为2097.69元/1年起。本文将详细解析阿里云企业级云服务器的价格体系,涵盖实例规格、收费标准与活动及选型指南等,以供了解和参考。
|
存储 人工智能 运维
龙蜥副理事长张东:加速推进 AI+OS 深度融合,打造最 AI 的服务器操作系统
操作系统如何满足 AI 应用场景需求?未来发展趋势如何?
如何查看自己电脑的windows系统版本?
这篇文章提供了一种简单快捷的方法来查看自己电脑的Windows系统版本,通过使用Windows的"运行"功能并输入`winver`命令来快速获取系统版本信息。
如何查看自己电脑的windows系统版本?
|
存储 弹性计算 安全
阿里云服务器付费类型、地域、镜像、存储、带宽和安全组设置与选择注意事项参考
在我们通过自定义购买的方式购买阿里云服务器器ECS时,会有多个选项,有的新手用户可能并不是很清楚这些选项是什么,选择或设置时需要注意什么,本文将从付费类型、地域与可用区、镜像、存储、带宽和安全组等多个方面,为您详细解析云服务器购买过程中各个参数与配置的选择注意事项,以供参考。
595 66
|
编解码 人工智能
FreeScale:无需微调即可提升模型的图像生成能力,生成 8K 分辨率的高质量图像
FreeScale是一个无需微调的推理框架,旨在提升扩散模型生成高分辨率图像和视频的能力。该框架通过处理和融合不同尺度的信息,首次实现了8K分辨率图像的生成,显著提高了生成内容的质量和保真度,同时减少了推理时间。
428 20
FreeScale:无需微调即可提升模型的图像生成能力,生成 8K 分辨率的高质量图像
|
存储 弹性计算 负载均衡
活动实践 | ALB 实现跨地域负载均衡
本方案通过阿里云的云企业网(CEN)、转发路由器(TR)、专有网络(VPC)、云服务器(ECS)和应用型负载均衡(ALB),实现跨地域的应用负载均衡。它扩展了系统的吞吐能力,提升了可用性和安全性。用户可通过资源编排服务(ROS)一键部署,并进行负载测试验证。清理资源也简便快捷。
|
人工智能 弹性计算 运维
ECS控制台,AI助手与极简管控体验
本文介绍了ECS控制台的演进及最新AI工具功能。控制台作为运维平台,需兼顾用户体验、可靠性和安全性。针对不同用户(个人开发者、企业级用户、资源管理员和架构师),控制台提供了定制化AI助手,涵盖售前选型、售中购买、售后运维等全链路支持。AI助手可智能分析用户需求,推荐合适规格,并提供实例诊断、命令解释等功能,简化操作流程。此外,还推出了简洁版控制台,优化了小资源量用户的使用体验,减少复杂度,提升效率。未来,控制台将朝着更智能、个性化的chat ops方向发展。
|
数据采集 物联网
三分钟轻松搞定固定资产盘点--首码RFID资产盘点小助手
首码 RFID 盘点小助手是一款功能强大、操作便捷的资产管理工具,能够助力企业在短短 3 分钟内轻松完成资产盘点
565 9