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

2023-08-02 11:34:28 +08:00
 cx2ex
这些年接触过不少国内开源的项目,例如阿里、腾讯、百度这些大公司或者一些个人的开发者。在项目开源初期甚至是中后期,有一些项目都缺乏中文文档,只提供英文文档。有的中文文档还是第三方翻译,非官方的。
4173 次点击
所在节点    开源软件
45 条回复
Rache1
2023-08-02 13:36:15 +08:00
BifroMQ
2023-08-02 13:36:20 +08:00
@clino 同意,我理解是对受众群体的选择原因。

比如开源个做小程序的框架,就很少有团队会只写英文文档,甚至完全不会去写英文文档,因为受众全部在国内。
但是如果是底层框架、中间件之类,一般会出英文文档。

比如我们的 https://bifromq.io/ 开源 MQTT 消息中间件,就因为要同时兼顾海外&国内用户做的双语文档。
当然,维护成本确实也确实高不少。
cbythe434
2023-08-02 14:20:16 +08:00
背靠大公司,做开源老板基本都有海外背景,或者要向海外竞品对标
东西好不好不重要,英文舞台更大,彰显影响力,中文显得格局小了
Biggoldfish
2023-08-02 14:25:34 +08:00
因为不指望读英文文档都费劲的会给你认真提 issue 更不用说是开 PR 回馈了
fzls
2023-08-02 14:40:03 +08:00
因为现状是会参与进来提 pr 的大部分是国外人吧-。-而且很多这类产品的国外用户更多,也更愿意捐赠
FeatureProbe
2023-08-02 15:11:12 +08:00
以自己的开源项目为例( https://github.com/FeatureProbe/FeatureProbe ),中英文都有,Github 的 readme 是英文,如果不想看英文也提供链接直接跳转到 Gitee 看中文,主要觉得英文不会受到语言限制,可以让更多人参与开源进来。
tin3w5
2023-08-02 15:17:09 +08:00
答案就在问题里,人家是开源项目。文档当然是越多人能读懂越好,用户是文档的一个受众群体,另一个更大的群体是开源代码贡献者。
另外,很多国内组织主导的开源项目被某些有背景的商业利益公司搞的名声很臭,要么不完全开源,想要完整版就要付费。要么开源出来的东西几百辈子不维护,大家提的 pr 几个月都没人管。很多国内个人搞的开源项目都尽可能伪装成国外的开源爱好者或团队,搞出口转内销。
NoOneNoBody
2023-08-02 15:17:40 +08:00
当然是 —— “我想和谁交流”
yzbythesea
2023-08-02 15:19:39 +08:00
1.简中巨婴多
2.和老外交流有新鲜感
3.开源一般技术新,很多新技术都没中文文档,中英夹杂写蛋疼
MAKF
2023-08-02 17:48:17 +08:00
@cx2ex 是的没错
28Sv0ngQfIE7Yloe
2023-08-02 18:01:50 +08:00
过滤 提纯
jsq2627
2023-08-02 20:02:40 +08:00
https://www.jetbrains.com/lp/devecosystem-2022/

Which language do you mainly use at work?
67% English
20% Chinese

What languages do you use with family and friends?
15% English
14% Chinese
jsq2627
2023-08-02 20:12:42 +08:00
@Pencillll 我再补充一点,但凡项目里出现任何一个汉字,外国人的好感度也会下降很多,会阻碍开源项目的全球推广。例如:

- README 和文档是略显憋足的英文,issue/PR 区全是中文
- 作者用中文在 issue/PR 里沟通
- 提供中英双语文档

反面案例:ant design
正面案例:vue
wyllan
2023-08-02 20:41:03 +08:00
@me1onsoda 你説中文的時候腦子會先來一遍方言嗎?
MeMoDiv
2023-08-02 20:59:13 +08:00
一个简单的例子
MeMoDiv
2023-08-02 20:59:18 +08:00
snw
2023-08-02 21:05:01 +08:00
因为不用切换输入法啊
ming2077
2023-08-02 21:09:59 +08:00
@cest 充分条件和必要条件都整不明白,“truth hurts”,噗嗤
cx2ex
2023-08-02 21:45:58 +08:00
@MeMoDiv 国产开源是非多🙃
MeMoDiv
2023-08-02 21:55:12 +08:00
@ming2077 #37 这还真是充分条件,英文弱到没有办法做可以用翻译工具辅助的无限时阅读理解的话,基本没可能自己解决部署使用开源项目过程中会遇到的问题,万一被百度上的教学灌输了“issue 是用来找客服的”这种观念,后果不堪设想。不是必要条件是因为有的人英文足够好,但却是纯脑残,这和在开源坑里叫天天不应叫地地不灵的可怜小白也有本质不同。

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

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

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

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

© 2021 V2EX