起因是写了一个开源的项目: https://github.com/wy-luke/StableDiffusion-Installer-For-Mac (原谅我打了个广告)
在里面写了两份 README ,中文和英文的,纠结了好久,是中文放在首页还是英文放在首页
会考虑很多因素
一方面,这里毕竟是英文为主的社区嘛,作为程序员大家应该都理解,这个应该就不用多解释了
另一方面,觉得自己作为中国人,用母语无可厚非,也能宣扬一下我们国家,同时也是怕被喷,我见过不止一次有人喷,作为中国人但是 README 放的却是英文这件事了
我最终把英文放在首页是因为,看到阿里的一些仓库采用的也是英文,最终一狠心用了英文
我确实是自己想的多,也知道不用太在意别人的看法,自己的项目想怎样就怎样
这里我们不去说哪个对、哪个错,无论哪种都有一定的道理,只是想和大家理性地探讨一下,看看大家更倾向于哪种方式,出于好奇,也出于寻求解决方案
可能有人没有做过相关工作哈,那就假设,如果你有一个开源项目,你会怎么选择,为什么?
想做一个简单的投票,分别在 1 楼和 2 楼回复两个选项,如果你更倾向于某种方式,可以为其加个感谢
(感觉有点像骗感谢来了。。。)
目前来看,其实大多数还是倾向于使用英文的
这个结果其实是意料之中,一来大家素质水平较高,都互相理解,不会因为这点小事喷人,二来程序员居多
但有些回复还是有点跑偏了,“见人说人话,见鬼说鬼话”,这是固然,当我的产品仅面向中文用户,我会毫不犹豫地使用中文,甚至可能不会写英文文档
这个帖子想和大家讨论的是,我们抛开其他的一切,不管你的英文好或不好,不管你有没有项目,你的产品受众也是两开花,难分伯仲,此时,你会如何选择?
把英文放在首页,主要更新,附一个中文文档链接;还是中文放首页,附一个英文文档链接?为什么
1
EatMi OP 中文
|
2
EatMi OP 英文
|
3
xipuxiaoyehua 2023-08-31 13:32:45 +08:00 3
技术类的我会更偏向于使用英文
|
4
jstony 2023-08-31 13:34:24 +08:00 4
看情况,面向的主要是中文受众就中文,面向的主要是英文受众就英文。
|
5
artnowben 2023-08-31 13:35:05 +08:00 1
我在做 dperf 的时候,也考虑过这个问题,最终是中英文都有,英文方便国际化,中文方便国内用户,有中文、英文切换的链接。
https://github.com/baidu/dperf/ |
9
artnowben 2023-08-31 13:36:45 +08:00 1
dperf 最终只会用英文,维护中英文太费精力了
|
10
zhangxh1023 2023-08-31 13:37:20 +08:00 1
英文写的够好,自信,就优先英文 😂
|
11
kdwnil 2023-08-31 13:37:46 +08:00 via Android 1
自娱自乐的项目懒得翻译/仅面向中文用户(比如外语翻译成中文)用中文,其余用英文然后随缘附加中文 readme
|
12
EatMi OP @jstony 了解你的意思,谢谢。有时候我确实会难以判断出,项目的“主要”受众是哪边。但是看大多数这种情况下,会采用英文作为首选,然后附上中文链接
|
13
EatMi OP @xipuxiaoyehua 好像确实大多数也是这样,就比如国内一些大厂的开源项目,除非是很“鲜明”地面向国内用户,一般的技术项目都会采用英文首选
|
14
EatMi OP @zhangxh1023 以前可能确实有英文水平这个问题在,但是现在有了 ChatGPT 的加持,自己再稍微改改,写出一份质量不错的英文文档不算特别困难
|
17
EatMi OP @artnowben #5 哇,刚注意到,是百度的大佬呢。公司内部在做这种项目的时候,关于英文首页还是中文首页,会有相关规定吗?还是说全凭开发者习惯
|
19
kongkx 2023-08-31 14:02:15 +08:00 via iPhone 1
中英写在一个文件里面如何
|
20
cnbatch 2023-08-31 14:04:54 +08:00 1
目标用户是中文用户的话,就用中文 + 英文链接;否则就英文 + 中文链接。
到目前为止,我个人的项目都明确考虑过用户群,所以不会在中文还是英文浪费过份的时间 至于我工作时公司的项目……都是内部使用的,不对外开放,说出来没意义。 |
21
janus77 2023-08-31 14:07:10 +08:00 1
我同意按主要受众为标准的办法
如果你不确定谁是主要的,看看你的宣传阵地,你如果在中文社区宣传多,引流来的中文用户就多,issue 里面提中文的也多。 |
22
lifesimple 2023-08-31 14:07:27 +08:00 2
|
23
EatMi OP @lifesimple #22 鬼才
|
24
villivateur 2023-08-31 14:21:52 +08:00 1
@lifesimple 这还是有偏有倚的,凭什么中文文档在左,英文在右[/狗头]
|
25
EatMi OP @villivateur #24 鬼中鬼才
|
26
cwcc 2023-08-31 14:27:26 +08:00 1
|
27
skiy 2023-08-31 14:29:25 +08:00 2
我见过小程序的 README 用英文的。
笑不活了。老外的软件有小程序的吗?或者说有外包开发小程序开发给老外的吗? |
28
duzhuo 2023-08-31 14:36:31 +08:00 via Android 1
见人说人话 见鬼说鬼话
|
29
WillBeethoven 2023-08-31 14:39:16 +08:00 1
默认英文,只面向中文网站/内容的项目才用中文。
|
30
EatMi OP @skiy #27 其实也可以理解,一方面可能作者是出于练习目的,尝试使用英文 README ,另一方面,我们不得不承认,有时候英文就会显得更“专业”😂
|
31
callmesmc 2023-08-31 15:34:59 +08:00 via iPhone 1
我也见过喷别人 readme 不用中文的,感觉好奇葩,为什么默认作者和其他用户都是中国人
|
32
kwanzaa 2023-08-31 15:54:50 +08:00 1
见人说人话,见鬼说鬼话。
要不就默认 En ,给个 Zh 的超链。 |
33
Pencillll 2023-08-31 16:03:21 +08:00 1
用英文一劳永逸,老外和大部分国人都能看懂
以前还会额外提供中文版,现在不打算提供了,本来写文档就又费劲又无聊,维护两份文档直接超级加倍,还要考虑是否同步的问题,不如把精力省下来多写点代码 |
34
Lockeysama 2023-08-31 16:05:41 +08:00 1
本来想房中文的,后来放了英文,因为之前写了 Python 的 SDK ,因为 setup.py 里面引用了中文 readme ,导致在 Windows 下安装 SDK 一直编码报错。后来就索性直接用英文了。
|
35
qquantt 2023-08-31 16:07:08 +08:00 1
不用局限在 README
我和我妈只说村里话,和中小学同学基本说县里话,会中文的朋友我就说中文,以上都不会就英文,英文还不行就找个翻译机器。 |
36
tool2d 2023-08-31 16:08:19 +08:00 1
这就和软件是否需要出多语言版本一个道理,有人看还是需要的,毕竟有需求在。
有 gpt 帮助,翻译一般来说不是太大的问题,比以前没有的时候,要省力多了。 |
37
flyqie 2023-08-31 16:13:16 +08:00 via Android 1
default eng
|
38
jadelike 2023-08-31 16:14:16 +08:00 1
中文,因为我看不懂英文
|
39
fredweili 2023-08-31 16:38:05 +08:00 1
github 上不写英文,就是想内卷
|
40
TianHeiLeKuaiPao 2023-08-31 16:45:22 +08:00
预测又是一个撕逼贴
|
41
LitterGopher 2023-08-31 16:45:27 +08:00 1
中文开发者能看懂英文文档是基本需求,反过来却不是。直白的说就是,写英文版传播范围可能会更广(也只是可能)。
|
42
EatMi OP @TianHeiLeKuaiPao #40 也不能这么说,目前为止大家的讨论还是很友善的。不去说谁对谁错,谁优谁劣,这个前提下其实也不太容易撕起来,这样挺好
|
43
FeatureProbe 2023-08-31 16:53:37 +08:00 1
Github 是英文,提供了中文链接,如果不想看英文可以直接跳转到 Gitee 查看。
|
44
jlmzzz 2023-08-31 17:54:27 +08:00 1
在大多数情况下,请使用英语。如果您想表示尊重,请加上中文。
|
45
dabaibai 2023-08-31 17:57:39 +08:00 1
英文极其差 就用中文吧
|
46
LykorisR 2023-08-31 18:03:07 +08:00 1
英文
|
48
EatMi OP @Lockeysama #34 确实,中文的这种兼容性比较棘手
|
49
EatMi OP @qquantt #35 对,理解你的意思,就是看目标用户嘛,但有时候就是没有一个“主要”的用户群,想两开花,在这种情况下的倾向性,是我想来讨论的
|
53
EatMi OP @FeatureProbe #43 嗯嗯,我看到你的项目是这样做的,但是我实在不喜欢 Gitee ,哈哈。我的看法是技术是中立的,GitHub 也不存在一个官方语言,只能说大家默认使用英文来,而且上面也有很多其他国家语言的仓库
|
54
EatMi OP @LitterGopher #41 对,这是一方面,英文能够做到兼顾,但是中文却不能
|
55
EatMi OP @fredweili #39 其实还好啦,都已经上 GitHub 了,无论带不带功利性的目的,做的东西起码都是免费分享给大家的
|
57
dann73580 2023-08-31 21:38:20 +08:00
其实没什么对错,更多还是看产品市场吧。这是纯实用主义的角度。
当然,中文优先,对自己民族文化有认同,愿意使用并且推广,十分理解而且尊重。 不管怎么选,都是对的。看你价值观更侧重什么方面。 |
58
dann73580 2023-08-31 21:41:22 +08:00
@dann73580 补一句:如果你认为作品是自己的代表的话,我建议中文优先。开源本身就是一种政治倾向。立场鲜明的,自信的表达我是中国开发者,是非常有个性,也是非常酷的一件事。
|
59
EatMi OP @dann73580 #57 对的,没有孰对孰错,就只是个人倾向,对于你“开源是一种政治倾向”我不太认同,我认为技术就应该仅仅是技术,纯粹的技术,如果让技术染上政治,会有很多不必要的麻烦,比如美国如果严重制裁,就应该舍弃所有美国的开源相关技术吗,那肯定是做不到的。而且我们就只是想做做技术嘛,不想管那么多的有的没的,生活已经很不容易了。但是我尊重你的看法哈,现在也有很多开源仓库会有“支持乌克兰”等政治立场在。对于宣扬民族文化,我也认同,我也觉得很酷,这也是我会认真考虑使用中文有限的重要原因,否则我可能就直接使用英文了。
|
60
joesonw 2023-08-31 22:21:55 +08:00 via iPhone 1
一般只用英文,要上 v 站宣传的时候会再 jiage 中文的。
|
61
tyzandhr 2023-08-31 22:59:11 +08:00 via Android 1
拉丁语。
|
63
maokabc 2023-08-31 23:10:20 +08:00 via Android 1
英文差,机翻英文还不如直接中文,毕竟还有大把喜欢替别人尴尬的人。外国人要用,他们自己机翻一下可能更准确。
|
66
EatMi OP @kongkx #19 对,文档较小的话确实可以,还方便,我的一个项目就是这样做的。那么问题又来了,是英文在上面还是中文在上面🤣
|
67
Dipous 2023-09-01 01:17:31 +08:00
拿中文写的就中文,拿英文写的就英文呗
|
68
hsfzxjy 2023-09-01 01:35:05 +08:00 via Android 1
一般只用英文,平时写英文多于中文
|
69
dann73580 2023-09-01 04:30:23 +08:00
@EatMi 这个是我没说清。我是说开源这个行为本身,就是一种理念。可能用政治理念这个词模糊了重点。所以优先中文,在不增加额外工作量的情况下,表达自己的理念,是非常酷且值得尊重的。
|
70
voidmnwzp 2023-09-01 05:00:17 +08:00 via iPhone 1
给中国人用的就写中文,全球通用的 比如轮子之类的就用英文 我就是这样的
|
71
iintothewind 2023-09-01 05:10:11 +08:00 1
默认肯定得是英文文档,然后在考虑中文文档,毕竟技术文档,英文更方便传播。
|
72
baobao1270 2023-09-01 06:19:27 +08:00 1
我会提供中英双语,但是优先英文( README.md 是英文,README_ZH.md 是中文)
|
73
begeneral 2023-09-01 07:12:28 +08:00
有啥区别,甲骨文都行
|
74
kongkx 2023-09-01 07:24:11 +08:00 via iPhone
|
75
klo424 2023-09-01 08:31:50 +08:00 1
现在都 gpt 翻译了,英文中文全写上也不费劲,个人比较喜欢中英文双语的写法。
例如: # 我的世界 Minecraft > 《我的世界》是一款沙盒类电子游戏,开创者为马库斯·阿列克谢·泊松。游戏由 Mojang Studios 维护,现隶属于微软 Xbox 游戏工作室。游戏最初于 2009 年 5 月 17 日作为 Classic 版本发布,并于 2011 年 11 月 18 日发布 Java 正式版。我的世界的游戏平台囊括桌面设备、移动设备和游戏主机。 中国版现由网易游戏代理,于 2016 年 5 月 20 日在中国大陆运营。 > > Minecraft is an open-world survival and multiplayer game, originally designed and created by Notch of Mojang. > Minecraft is available for PC, mobile and various gaming consoles, the game allows players to place and destroy a variety of blocks in a 3D environment. Within this 3D environment, players can roam around, free to do and build anything they want. |
76
tairan2006 2023-09-01 08:34:45 +08:00 1
如果是给国人用的项目,当然还是中文优先
如果跟国别无关,一般优先英文 |
77
themelody0 2023-09-01 08:39:35 +08:00 1
我曾经见过多次有用中文 README 被喷的
|
78
EatMi OP @begeneral #73 硬要说确实也没啥区别,影响不大。但不可否认这些东西还有会有一些意识形态的因素在里面的,只是想和大家理性讨论讨论哈,可以理解为纯粹是我的好奇,看看大家的想法
|
79
chinaguaiu 2023-09-01 09:24:30 +08:00 1
很多中文项目自己刷星然后卖课,整个中文用户群体给人的印象瞬间不好了...写英文吧
|
80
EatMi OP @themelody0 #77 这种情况挺多的,令人不悦😑
|
81
wyl986 2023-09-01 09:44:12 +08:00 1
在 GitHub 只使用英文可以过滤掉很大一部分垃圾用户和垃圾仓库
|
82
wudicgi 2023-09-01 09:49:14 +08:00 1
我是把中英文写在一个 readme 里
如果分开的话,首页放英文的比较好 |
83
EatMi OP @chinaguaiu #79 这种情况确实,把脸丢到国外去了。
|
84
EatMi OP @wyl986 #81 我比较同意你的观点,能够起到过滤作用。但是我认为用户倒是没有垃圾、不垃圾之分,只要用我的产品,就是好用户哈哈。不过提问、建群之类的,使用英文或者 TG ,来过滤一下,会有很好的作用
|
85
dog82 2023-09-01 10:12:34 +08:00 1
没人看,不写
|
86
agagega 2023-09-01 11:17:32 +08:00 1
现在有了 ChatGPT ,不如再加上日文、德文、法文、西班牙文、俄文的 README 。
https://github.com/github/markup/issues/899 GitHub 用户希望能有多语言 README 支持已经很久了,只是迟迟没一个官方方案。起码法文的俄文的西班牙文的我都见过,人用母语不可耻 |
87
RainCats 2023-09-01 11:23:03 +08:00 1
中文,如果其他语言群体有需要,他们会自行翻译,翻译工具这么多,甚至还有 AI 工具
|
88
ZeroDu 2023-09-01 12:45:00 +08:00 1
两个都 提供,默认英文,毕竟 github 也是全英文的,英文也算是国际比较广泛的语种;
但是非常反感装老外,好像写中文掉价一样。同时国内程序员群体还是很大的,中文还是很有必要的。 |
89
ryan4yin 2023-09-01 12:52:51 +08:00 1
维护两个版本太麻烦了,我 README 只有英文的,因为感觉想看我这项目的人,这点英文读下去应该没难度。
|
90
andytao 2023-09-01 12:58:53 +08:00 1
中国人维护的项目强烈建议一定要有中文,有没有英文自己看着办,但一定要有中文,因为中文是我们的母语和根,不能丢了自己的根呀。
Github 是英语社区,它就没有提供多语言的规范和支持,说明啥? 说明它期望甚至强迫我们写英文文档,丰富英文社区,可我们是华夏儿女,用的是中文汉字呀。咱们不能用自己水电和生命,单纯去丰富他人的社区,进而导致了我们的儿孙看不懂、学不会我们创造的东西。 |
91
ZeroDu 2023-09-01 13:02:46 +08:00
|
92
andytao 2023-09-01 13:05:42 +08:00
中国人维护的项目强烈建议一定要有中文,有没有英文自己看着办,但一定要有中文,因为中文是我们的母语和根,不能丢了自己的根呀。
Github 是英语社区,它就没有提供多语言的规范和支持,说明啥? https://github.com/github/markup/issues/899 说明它期望甚至强迫我们写英文文档,丰富英文社区,可我们是华夏儿女,用的是中文汉字呀。咱们不能用自己水、电和生命,单纯去丰富他人的社区,进而导致了我们的儿孙看不懂、学不会我们创造的东西。 |
93
andytao 2023-09-01 13:15:01 +08:00
Github 是一个国际社区,它没有提供 README 的多语言规范指引和支持,说明它有一定的文化殖民倾向。
只要我你他的儿孙还是用中文,就应该优先用中文写 README ,这样他们就可以循着足迹找到我们的作品,了解我们曾经的过往,老外看不懂可以用翻译嘛,不用太考虑他们。 |
94
wangmou 2023-09-01 13:28:14 +08:00
看受众。其实最烦的就是那些受众是国人,然后非要装逼写英文,外国人又用不到你那东西,英文写的也别别扭扭何必呢。。。
|
95
dif 2023-09-01 14:38:36 +08:00 1
如果你主要针对国人,那就中文优先。
如果你野心大,要面向国际,那就英文优先。 |
96
andytao 2023-09-01 16:05:51 +08:00 1
如果软件或库很优秀,就算 README 用的是中文,老外会用翻译工具来学习使用它;
如果软件或库很低劣,就算 README 用的是英文,国内国外用户都不会有人来鸟它; README 用中文还是英文很关键吗?不是,那么用最省力的语言写 README 就好了。 |
97
EatMi OP @wangmou #94 兄弟,感觉你稍微有点偏激了,人家本来就是开源免费的东西,为爱发电,而且作为作者本人的东西,写什么也都无可厚非,没有必要这么说,平和一点嘛,可能也不是要装逼,可能就是想锻炼一下,或者往功利处讲,可能写英文更有利于他本人呢,比如找工作加分项等
|
98
EatMi OP @andytao #96 对,你说的在理,但是项目初期的话,个人项目,可能还是稍微会有点影响的。但这也不是重点,更想和大家讨论的是主观层面的意愿和倾向
|