大家项目的 README 习惯放中文还是英文?

2023-08-31 13:29:56 +08:00
 EatMi

起因是写了一个开源的项目: https://github.com/wy-luke/StableDiffusion-Installer-For-Mac (原谅我打了个广告)

在里面写了两份 README ,中文和英文的,纠结了好久,是中文放在首页还是英文放在首页

会考虑很多因素

一方面,这里毕竟是英文为主的社区嘛,作为程序员大家应该都理解,这个应该就不用多解释了

另一方面,觉得自己作为中国人,用母语无可厚非,也能宣扬一下我们国家,同时也是怕被喷,我见过不止一次有人喷,作为中国人但是 README 放的却是英文这件事了

我最终把英文放在首页是因为,看到阿里的一些仓库采用的也是英文,最终一狠心用了英文

我确实是自己想的多,也知道不用太在意别人的看法,自己的项目想怎样就怎样

这里我们不去说哪个对、哪个错,无论哪种都有一定的道理,只是想和大家理性地探讨一下,看看大家更倾向于哪种方式,出于好奇,也出于寻求解决方案

可能有人没有做过相关工作哈,那就假设,如果你有一个开源项目,你会怎么选择,为什么?

想做一个简单的投票,分别在 1 楼和 2 楼回复两个选项,如果你更倾向于某种方式,可以为其加个感谢

(感觉有点像骗感谢来了。。。)

7018 次点击
所在节点    程序员
101 条回复
LitterGopher
2023-08-31 16:45:27 +08:00
中文开发者能看懂英文文档是基本需求,反过来却不是。直白的说就是,写英文版传播范围可能会更广(也只是可能)。
EatMi
2023-08-31 16:50:06 +08:00
@TianHeiLeKuaiPao #40 也不能这么说,目前为止大家的讨论还是很友善的。不去说谁对谁错,谁优谁劣,这个前提下其实也不太容易撕起来,这样挺好
FeatureProbe
2023-08-31 16:53:37 +08:00
Github 是英文,提供了中文链接,如果不想看英文可以直接跳转到 Gitee 查看。
jlmzzz
2023-08-31 17:54:27 +08:00
在大多数情况下,请使用英语。如果您想表示尊重,请加上中文。
dabaibai
2023-08-31 17:57:39 +08:00
英文极其差 就用中文吧
LykorisR
2023-08-31 18:03:07 +08:00
英文
EatMi
2023-08-31 18:50:10 +08:00
@Pencillll #33 你说的有道理,主要还是看作者本人的精力和意愿了。同时英文能够兼顾,但是中文却只能面国内用户
EatMi
2023-08-31 18:51:04 +08:00
@Lockeysama #34 确实,中文的这种兼容性比较棘手
EatMi
2023-08-31 18:52:39 +08:00
@qquantt #35 对,理解你的意思,就是看目标用户嘛,但有时候就是没有一个“主要”的用户群,想两开花,在这种情况下的倾向性,是我想来讨论的
EatMi
2023-08-31 18:53:28 +08:00
@tool2d #36 确实省力多了,但是每次更新都得去同步一下,久而久之应该还会感觉到疲累 😂
EatMi
2023-08-31 18:53:39 +08:00
@flyqie #37 get
EatMi
2023-08-31 19:34:47 +08:00
@jlmzzz #44 您指的尊重是向哪一方的尊重?
EatMi
2023-08-31 19:37:24 +08:00
@FeatureProbe #43 嗯嗯,我看到你的项目是这样做的,但是我实在不喜欢 Gitee ,哈哈。我的看法是技术是中立的,GitHub 也不存在一个官方语言,只能说大家默认使用英文来,而且上面也有很多其他国家语言的仓库
EatMi
2023-08-31 19:37:56 +08:00
@LitterGopher #41 对,这是一方面,英文能够做到兼顾,但是中文却不能
EatMi
2023-08-31 19:39:54 +08:00
@fredweili #39 其实还好啦,都已经上 GitHub 了,无论带不带功利性的目的,做的东西起码都是免费分享给大家的
EatMi
2023-08-31 19:40:48 +08:00
@callmesmc #31 是的,虽然知道不用理会这种人,但还是会被影响到心情,令人难过且生气
dann73580
2023-08-31 21:38:20 +08:00
其实没什么对错,更多还是看产品市场吧。这是纯实用主义的角度。

当然,中文优先,对自己民族文化有认同,愿意使用并且推广,十分理解而且尊重。

不管怎么选,都是对的。看你价值观更侧重什么方面。
dann73580
2023-08-31 21:41:22 +08:00
@dann73580 补一句:如果你认为作品是自己的代表的话,我建议中文优先。开源本身就是一种政治倾向。立场鲜明的,自信的表达我是中国开发者,是非常有个性,也是非常酷的一件事。
EatMi
2023-08-31 22:11:06 +08:00
@dann73580 #57 对的,没有孰对孰错,就只是个人倾向,对于你“开源是一种政治倾向”我不太认同,我认为技术就应该仅仅是技术,纯粹的技术,如果让技术染上政治,会有很多不必要的麻烦,比如美国如果严重制裁,就应该舍弃所有美国的开源相关技术吗,那肯定是做不到的。而且我们就只是想做做技术嘛,不想管那么多的有的没的,生活已经很不容易了。但是我尊重你的看法哈,现在也有很多开源仓库会有“支持乌克兰”等政治立场在。对于宣扬民族文化,我也认同,我也觉得很酷,这也是我会认真考虑使用中文有限的重要原因,否则我可能就直接使用英文了。
joesonw
2023-08-31 22:21:55 +08:00
一般只用英文,要上 v 站宣传的时候会再 jiage 中文的。

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

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

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

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

© 2021 V2EX