V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
apoclast
V2EX  ›  问与答

纠结文档用什么语言写

  •  
  •   apoclast · 2011-04-29 15:35:50 +08:00 · 4323 次点击
    这是一个创建于 4957 天前的主题,其中的信息可能已经有所发展或是发生改变。
    平时写注释/文档的时候, 总是纠结这个问题.

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

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


    继续纠结中...≧︿≦ 嗷!!!
    2 条回复    1970-01-01 08:00:00 +08:00
    chone
        1
    chone  
       2011-04-29 15:38:14 +08:00
    再补充一个用英文的优点:
    不用切换输入法,提高效率,最主要的是不打断思路
    ssword
        2
    ssword  
       2011-04-29 16:12:13 +08:00
    中文吧。文档毕竟是给别人看的,用母语对谁都好
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2251 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 28ms · UTC 01:39 · PVG 09:39 · LAX 17:39 · JFK 20:39
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.