# 放在笔记里方便别人改

**URL:** <https://buildx.do/t/%E6%94%BE%E5%9C%A8%E7%AC%94%E8%AE%B0%E9%87%8C%E6%96%B9%E4%BE%BF%E5%88%AB%E4%BA%BA%E6%94%B9/188>\
**Category:** 笔记共建\
**Tags:** 原创翻译\
**Created:** [2026 年10 月 6 日 22:46 UTC](https://buildx.do/t/%E6%94%BE%E5%9C%A8%E7%AC%94%E8%AE%B0%E9%87%8C%E6%96%B9%E4%BE%BF%E5%88%AB%E4%BA%BA%E6%94%B9/188 "2026-10-06T22:46:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![suyanran](https://buildx.do/letter_avatar_proxy/v4/letter/s/b2d939/32.png) [@suyanran](https://buildx.do/u/suyanran)\
**Post date:** [2026 年10 月 6 日 22:46 UTC](https://buildx.do/t/%E6%94%BE%E5%9C%A8%E7%AC%94%E8%AE%B0%E9%87%8C%E6%96%B9%E4%BE%BF%E5%88%AB%E4%BA%BA%E6%94%B9/188/1 "2026-10-06T22:46:00Z")

</div>

「放在笔记里方便别人改」。

别只留在我自己的草稿。错了就能看见。

给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。

译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能试。我的理解写在引用外面，不把猜测写成作者的话。原文后来改了，就把差异补在末尾，不悄悄改正文。

收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。

复查「放在笔记里方便别人改」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。翻译的标准是别人能照着做。术语对照放文末，正文不堆原文。例子若改成我们在用的语言，每一步都要还能试，试不通就标明卡在哪。只对当地读者有用的背景可以不译，做法不能丢。我的理解写在引用外面。原文后来有更新，把差异补在末尾，不悄悄改正文，这样早先的讨论还对得上。已经有官方中文的不重复译。没有把握的词保留原文在括号里，让别人直接改。

操作顺序。1. 先确认没有官方中文，有就不重复译。2. 术语对照列在文末，正文保持能读完。3. 例子改成我们的语言后，逐步试一遍，试不通就写明卡在哪一步。4. 只对当地读者有用的背景可以不译，做法不能省。5. 自己的理解放在引用之外。6. 原文若更新，把差异补在末尾，不改已经讨论过的正文。7. 没有把握的词在括号里留原文。别人能直接改词，而且照着步骤能做完，这篇翻译才算完成。

---

<div class="post-metadata">

**Author:** ![gaoyuan](https://buildx.do/letter_avatar_proxy/v4/letter/g/ccd318/32.png) [@gaoyuan](https://buildx.do/u/gaoyuan)\
**Post date:** [2026 年10 月 7 日 00:04 UTC](https://buildx.do/t/%E6%94%BE%E5%9C%A8%E7%AC%94%E8%AE%B0%E9%87%8C%E6%96%B9%E4%BE%BF%E5%88%AB%E4%BA%BA%E6%94%B9/188/2 "2026-10-07T00:04:00Z")

</div>

放在大家能改的地方。只留在个人草稿里，错了也没人看见。
