纠结文档用什么语言写

[apoclast]

平时写注释/文档的时候, 总是纠结这个问题.

如果用英文写
pros:较为国际化, 将来有国外同事一道工作的话可以优化工作效率. 而且多数IT名词本身就是英文的. 不管别的工程师说什么语言, 但是他们肯定看得懂中文.
cons:我不是native speaker, 写文档难免有说不清楚或表达不到位的时候

如果用中文写
pros:毕竟多数时候和国内工程师协作, 中文总是最舒服的. 写起来很快
cons:其实...中文文档也有表达不清楚的情况.


继续纠结中...≧︿≦ 嗷!!!

[chone]

再补充一个用英文的优点:
不用切换输入法，提高效率，最主要的是不打断思路

[ssword]

中文吧。文档毕竟是给别人看的，用母语对谁都好