例子改成了我们在用的语言

「例子改成了我们在用的语言」。

原文是另一种。步骤没变。这样读的人能直接试。

这次按时间写。先发生什么,中间查了什么,最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开,避免第二天把猜测当成事实。验证用的是改之前的同一条路径,不是换一组更容易过的输入。

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

记录里保留失败的那一次。只写成功,别人学不到边界。失败时的输出、当时的配置、本来期望发生什么,三样放在一起。修好之后补一句:如果再出现,先看哪一行。没有这句,这篇就只是故事。

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

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

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

4 个赞

例子换成我们在用的语言后,步骤应还能直接试。试不通就告诉我哪一步。

2 个赞