删了只对当地读者有用的段

「删了只对当地读者有用的段」。

剩下的是做法。背景太窄的没译。

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

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

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

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

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

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

5 个赞

删掉的是只对当地读者有用的背景。做法都还在。

3 个赞