把操作过程写清楚,核心是让读者在不问你的情况下,能按步骤复现同一结果。做法是:先写清目标与前置条件,再按“观察—判断—处理—复查”四段展开,每一步都给出可验证的动作和结果。如果读者读完仍要猜“点哪里、填什么、看到什么算成功”,说明过程还没写清。
操作过程写得乱,往往不是步骤漏了,而是起点没交代。开始写之前,先用一句话说明这次操作要达成什么,再列出三个要素:
例如,假设你要优化一个产品页的关键词布局,前置条件可以写成“已确定目标词、已有页面编辑权限、已备份当前版本”。完成标志写成“页面标题、首段和一处小标题都自然包含目标词,且不影响原句通顺”。这样读者知道从哪开始、到哪结束。
每个操作段落只做一件事,按固定顺序推进,读者就不容易迷失。
观察:写清当前状态。不要写“检查一下页面”,而要写“打开页面源码或编辑器,查看标题标签和首段文字,记录当前用词”。观察的结果要能被别人看到,比如复制出原标题、截图记录首段。
判断:根据观察结果决定改不改。判断标准要具体,比如“如果目标词只出现在页脚,而标题和首段都没有,就需要调整;如果标题已自然包含目标词,则不动标题”。判断依据来自页面实际内容,不是凭感觉。
处理:写清改什么、怎么改、改哪里。动作要细到可以照做,例如“把首段第一句的主语替换为目标词的同义表达,保持句子原意不变;在小标题中把泛称改为具体说法”。不要写“适当优化一下”,这种描述无法执行。
复查:给出检查项和判断结果。复查不是再看一眼,而是逐项确认:目标词是否出现在预期位置、句子是否通顺、是否误删原有信息、页面是否能正常打开。每项写清“通过”和“不通过”分别怎么处理。
下面是一个假设的对照,用来说明过程写清楚前后的差别。
不清楚的写法:“调整页面关键词,让内容更相关。”
清楚的写法:“打开产品页编辑器,查看标题标签。若标题未包含目标词,则在标题前部加入目标词,保持原品牌名在后;保存后刷新页面,确认标题显示完整且未被截断。若标题已包含目标词,则跳过标题,改查首段第一句,把笼统说法替换为具体说法。”
差别在于:后者有对象、有判断分支、有动作、有复查结果。读者照着做,能自己判断下一步。
复查环节决定操作过程是否可信。建议固定检查以下几项:
如果复查发现结果不一致,先回到“观察”环节,确认大家看到的初始状态是否相同。初始状态不同,后续步骤再细也会分叉。
把写好的操作过程交给没参与的人,让对方只读文字、不提问,独立走一遍。记录对方卡住的位置:卡在读不懂动作,就补动作细节;卡在不知道选哪个分支,就补判断条件;卡在不知道是否做完,就补完成标志。根据卡点修改,直到对方能复现同一结果。这一步能直接暴露“写清楚了”还是“自己以为写清楚了”。