SeeSharp入门培养日记4 -说明和注释中翻英

任务1：将JXI DSP工具包说明翻译英语

我们的软件都是中国工程师写的，有个中文说明书已经不错了。但是去年韩国客户买了5套，今年还要继续扩大到其他国家。好朋友都说，产品必须要有英文说明、范例（含注释）。于是，我下决心干。

我们的两位青年都放暑假了，英语都不错，于是我请他们先把JXI DSP 和 Mathematics工具包说明翻译为英语。

结果，他们体验出称给3部曲：谷歌翻译-Wikipedia-人工审阅。

1. 谷歌翻译可以正常用：
   https://translate.google.cn/
2. 维基百科靠人品，当然也可以用bing.com
   对于原来中文说明就讲解不清的的数学概念可以从英语百科书直接拷贝。
3. 最后，必须认真负责地人工读一遍。

结果很好，1周解决问题，已经送交客户试用。

任务2：将工具包范例里面的注释翻英语

这个难度较大，现在刚刚开始。

技巧1 找到关键cs文件

C#文本代码在cs文件，但是项目下面有很多winform相关的自动生成的代码。 可以在VS (visual studio)里面打开编辑注释的代码，看到文件名。

到范例目录也可以看到该文件：

除了用眼神确认，还可以用NotePad ++打开看看确认：

【注意】每个项目都有一套cs文件， 如果都是WinForm，那么都可能叫 MainForm.cs。要注意区分。

这样发给审阅人的文件就精简了。

后继如果有源， 我们再讲用git做源代码管理。

后记1

事实表明，原来软件注释就不多，而且google翻译真心好用。兼职生翻译完，自己通读一遍， 基本没毛病，最后给程序员边审稿边导入就可以。 具体方法很简单， 把翻译前中文注释的代码搞上Git，再把这些cs文件替换成兼职生加上英语的cs文件，Source Tree/ Git 自动比对，标出红绿代码行，一行一行确认就可以了。 由于代码简单注释不多，我决定保留中文原文， 在其上方加英语即可。