为什么国内开源项目普遍是先有英文文档,后才有中文文档甚至有的没有中文文档?

2023-08-02 11:34:28 +08:00
 cx2ex
这些年接触过不少国内开源的项目,例如阿里、腾讯、百度这些大公司或者一些个人的开发者。在项目开源初期甚至是中后期,有一些项目都缺乏中文文档,只提供英文文档。有的中文文档还是第三方翻译,非官方的。
4165 次点击
所在节点    开源软件
45 条回复
l0wkey
2023-08-02 11:38:58 +08:00
盲猜是为了过滤低质用户。
比如能拦住一些伸手党?然后真正有需求、有能力回馈社区的开发者,可能不在意这点语言门槛
clino
2023-08-02 11:42:24 +08:00
因为英文面向的用户更广啊
现在机翻这么方便,给英文和中文文档其实区别不太大
cx2ex
2023-08-02 11:44:21 +08:00
@clino 看过机翻的中文文档,读起来不是很顺畅 -_-|
cx2ex
2023-08-02 11:45:41 +08:00
@l0wkey 英文弱 == 低质用户 ???
inhzus
2023-08-02 11:48:08 +08:00
很简单的道理啊... 英文文档能看懂的人多啊
libook
2023-08-02 11:52:35 +08:00
英文已经不是特定地区或者人群的专用预言了,而是一种全球化工具,所以如果项目是面向全球的,首选就是英文。

一个项目足够火,自然就会出现其他语言的文档,每天新出现的轮子那么多,肯定不可能全都出翻译版本。
cest
2023-08-02 11:53:47 +08:00
@cx2ex #4
truth hurts
geelaw
2023-08-02 11:55:21 +08:00
功利的原因是先进的技术是先用英语写出来的,哲学的原因是没有在这方面追求文化认同。

提升到先进生产力(自由软件、开源软件、科研都是某种先进生产力),我最近的实践是两者结合,写文章还是会用英文,在国内学校作报告会坚持用汉语。
nothingistrue
2023-08-02 12:05:57 +08:00
首先,双语文档的成本非常高。

其次,跟什么人交流用什么语言。如果你是打算跟全世界人交流的,那么自然要用实质上的世界通用语——英语。你要玩游戏就会知道,全套都是法国人的育碧,其发行游戏的第一语言基本都是英语。如果你只打算跟国内的人交流,那主体语言肯定是母语。然后因为你不可明说的原因,压根就不可能存在国内社区。
AppJun
2023-08-02 12:08:45 +08:00
作为开发者,我想了下主要是以下几个原因:

1. 面向受众的语言是不特定的情况下,英文是覆盖率最广的。

2. 维护多套语言的文档其实是会增加代码无关工作量的,对于很多开发,让提供英文文档已经很艰难了。

3. 哪天偷懒导致中文或者什么非英文版本语言的文档内容过时了,可能会造成另外一种麻烦。

4. GitHub 对于 ReadME 多语言支持没有一个特别好的实践。

和文化认同啥的其实关系不大,说来说去就是成本低麻烦少。
nightwitch
2023-08-02 12:13:24 +08:00
看不懂英文文档的不是目标用户
z1645444
2023-08-02 12:28:37 +08:00
好像月初某天如厕时在知乎看过一样的话题
dayeye2006199
2023-08-02 12:35:23 +08:00
@cx2ex 不是英文弱的是低质用户,是低质用户伸手党戾气党,一般英文水平都没很好
me1onsoda
2023-08-02 12:37:29 +08:00
母语是中文,写英文文档的时候脑子也是先有中文再翻译成英文,写个中文文档不是顺手的事?
vsitebon
2023-08-02 12:44:32 +08:00
@me1onsoda 相当于做两份工作,除非是直接基于某一语言机翻过去
IvanLi127
2023-08-02 12:50:21 +08:00
@me1onsoda 不能吧?写英文的时候脑子里蹦出来的是中文,大概英文不好吧。。。
Pencillll
2023-08-02 12:52:11 +08:00
按照我的个人经验,但凡项目里出现了任何汉字,包括文档/注释/作者用户名,那么 issue 里基本上就全是中文了,如果你想让他们在 issue 里讲英文以便非中文用户检索,还会立刻被扣上一顶崇洋媚外的帽子并骂上一长串回复,所以我认为避免中文是最好的选择
andytao
2023-08-02 13:00:54 +08:00
我的主要项目 [袋鼠数据库工具] 第一语言是英语,刚开始有装逼的成分,然后是考虑到国外用户赞助、支持可能性更大,再后面是考虑到沟通国外用户更方便,其实写英文文档的成本更高,经常要借助语法类工具校正语法。

当然啦,中文也是一开始就有提供的,就是因为输出成本低,一口气就搞出来了。
liveoppo
2023-08-02 13:01:15 +08:00
不必添加英文之外的版本,机翻足够,看不懂的地方再去看英文即可

未来修改也方便,仅仅一个地方修改
smilenceX
2023-08-02 13:09:48 +08:00
和用户质量没关系。如果你这个项目面向全球,用英语是最好的选择。如果只是给中国人用,确实用中文更合适。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/961754

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX