写清楚条件
一条经验最好说明发生在什么环境、使用了什么工具、目标是什么,以及哪些因素可能影响结果。相同方法在不同设备、地区、预算和时间条件下可能产生不同结果。
如果涉及消费、职业或商业实践,应避免承诺收益、回报或“必成”。可以讨论方法和风险,但不能把不确定结果描述为确定利益。
记录失败也有用
失败过程常常比最终结果更有参考价值。说明哪里判断错了、怎样调整、什么情况下不建议继续,可以帮助他人减少重复试错。
对高风险操作,如电气维修、危险工具、极限运动等,不应只给简化步骤而忽略安全条件。必要时应建议使用合资格服务。
让经验保持可更新
软件版本、政策规则、产品设计都会改变。经验发布后,如果关键条件发生变化,应把它视为历史记录,并提醒读者核对当前信息。
海角论坛鼓励可复现但不绝对化的经验:写清楚事实、过程与限制,比漂亮口号更重要。