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

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

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

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

会考虑很多因素

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

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

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

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

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

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

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

（感觉有点像骗感谢来了。。。）

7202 次点击
所在节点    程序员
101 条回复
wyl986
2023-09-01 09:44:12 +08:00
在 GitHub 只使用英文可以过滤掉很大一部分垃圾用户和垃圾仓库
wudicgi
2023-09-01 09:49:14 +08:00
我是把中英文写在一个 readme 里
如果分开的话，首页放英文的比较好
EatMi
2023-09-01 09:53:17 +08:00
@chinaguaiu #79 这种情况确实，把脸丢到国外去了。
EatMi
2023-09-01 09:54:38 +08:00
@wyl986 #81 我比较同意你的观点，能够起到过滤作用。但是我认为用户倒是没有垃圾、不垃圾之分，只要用我的产品，就是好用户哈哈。不过提问、建群之类的，使用英文或者 TG ，来过滤一下，会有很好的作用
dog82
2023-09-01 10:12:34 +08:00
没人看，不写
agagega
2023-09-01 11:17:32 +08:00
现在有了 ChatGPT ，不如再加上日文、德文、法文、西班牙文、俄文的 README 。

https://github.com/github/markup/issues/899 GitHub 用户希望能有多语言 README 支持已经很久了，只是迟迟没一个官方方案。起码法文的俄文的西班牙文的我都见过，人用母语不可耻
RainCats
2023-09-01 11:23:03 +08:00
中文，如果其他语言群体有需要，他们会自行翻译，翻译工具这么多，甚至还有 AI 工具
ZeroDu
2023-09-01 12:45:00 +08:00
两个都 提供，默认英文，毕竟 github 也是全英文的，英文也算是国际比较广泛的语种；
但是非常反感装老外，好像写中文掉价一样。同时国内程序员群体还是很大的，中文还是很有必要的。
ryan4yin
2023-09-01 12:52:51 +08:00
维护两个版本太麻烦了，我 README 只有英文的，因为感觉想看我这项目的人，这点英文读下去应该没难度。
9dP06m83vIV00l72
2023-09-01 12:58:53 +08:00
中国人维护的项目强烈建议一定要有中文，有没有英文自己看着办，但一定要有中文，因为中文是我们的母语和根，不能丢了自己的根呀。

Github 是英语社区，它就没有提供多语言的规范和支持，说明啥？

说明它期望甚至强迫我们写英文文档，丰富英文社区，可我们是华夏儿女，用的是中文汉字呀。咱们不能用自己水电和生命，单纯去丰富他人的社区，进而导致了我们的儿孙看不懂、学不会我们创造的东西。
ZeroDu
2023-09-01 13:02:46 +08:00
@ZeroDu #88
补充：
对于一些随便写写，不准备推广，搞社区的项目我的观点是：“写不写管你屁事”，甚至 README 都没有
9dP06m83vIV00l72
2023-09-01 13:05:42 +08:00
中国人维护的项目强烈建议一定要有中文，有没有英文自己看着办，但一定要有中文，因为中文是我们的母语和根，不能丢了自己的根呀。

Github 是英语社区，它就没有提供多语言的规范和支持，说明啥？
https://github.com/github/markup/issues/899
说明它期望甚至强迫我们写英文文档，丰富英文社区，可我们是华夏儿女，用的是中文汉字呀。咱们不能用自己水、电和生命，单纯去丰富他人的社区，进而导致了我们的儿孙看不懂、学不会我们创造的东西。
9dP06m83vIV00l72
2023-09-01 13:15:01 +08:00
Github 是一个国际社区，它没有提供 README 的多语言规范指引和支持，说明它有一定的文化殖民倾向。

只要我你他的儿孙还是用中文，就应该优先用中文写 README ，这样他们就可以循着足迹找到我们的作品，了解我们曾经的过往，老外看不懂可以用翻译嘛，不用太考虑他们。
wangmou
2023-09-01 13:28:14 +08:00
看受众。其实最烦的就是那些受众是国人，然后非要装逼写英文，外国人又用不到你那东西，英文写的也别别扭扭何必呢。。。
dif
2023-09-01 14:38:36 +08:00
如果你主要针对国人，那就中文优先。
如果你野心大，要面向国际，那就英文优先。
9dP06m83vIV00l72
2023-09-01 16:05:51 +08:00
如果软件或库很优秀，就算 README 用的是中文，老外会用翻译工具来学习使用它；
如果软件或库很低劣，就算 README 用的是英文，国内国外用户都不会有人来鸟它；

README 用中文还是英文很关键吗？不是，那么用最省力的语言写 README 就好了。
EatMi
2023-09-01 21:31:43 +08:00
@wangmou #94 兄弟，感觉你稍微有点偏激了，人家本来就是开源免费的东西，为爱发电，而且作为作者本人的东西，写什么也都无可厚非，没有必要这么说，平和一点嘛，可能也不是要装逼，可能就是想锻炼一下，或者往功利处讲，可能写英文更有利于他本人呢，比如找工作加分项等
EatMi
2023-09-01 21:33:16 +08:00
@andytao #96 对，你说的在理，但是项目初期的话，个人项目，可能还是稍微会有点影响的。但这也不是重点，更想和大家讨论的是主观层面的意愿和倾向
wangmou
2023-09-03 18:50:44 +08:00
@EatMi 有些人写的东西一看就是机翻出来的，话都不通顺还加分项。
EatMi
2023-09-03 23:46:52 +08:00
@wangmou #99 对，你说得对，每个人一开始不都是从菜起步的吗。可能的确有些人纯为了装逼，随便机翻就放上去，观感也不好，但是和我说的有冲突吗？你不自己也说了有些人，那还是有些人，英文的 README 也是用心好好写的吧，这种不应该算加分项吗？

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

https://ex.noerr.eu.org/t/969742

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

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

© 2021 V2EX