大家项目的 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 条回复
tyzandhr
2023-08-31 22:59:11 +08:00
拉丁语。
qquantt
2023-08-31 23:04:38 +08:00
@EatMi 实在觉得有必要,就弄个中英文对照。
maokabc
2023-08-31 23:10:20 +08:00
英文差,机翻英文还不如直接中文,毕竟还有大把喜欢替别人尴尬的人。外国人要用,他们自己机翻一下可能更准确。
EatMi
2023-09-01 00:49:26 +08:00
@tyzandhr #61 好家伙
EatMi
2023-09-01 00:49:45 +08:00
@maokabc #63 搭配 ChatGPT 类似的工具会好很多
EatMi
2023-09-01 00:50:42 +08:00
@kongkx #19 对,文档较小的话确实可以,还方便,我的一个项目就是这样做的。那么问题又来了,是英文在上面还是中文在上面🤣
Dipous
2023-09-01 01:17:31 +08:00
拿中文写的就中文,拿英文写的就英文呗
hsfzxjy
2023-09-01 01:35:05 +08:00
一般只用英文,平时写英文多于中文
dann73580
2023-09-01 04:30:23 +08:00
@EatMi 这个是我没说清。我是说开源这个行为本身,就是一种理念。可能用政治理念这个词模糊了重点。所以优先中文,在不增加额外工作量的情况下,表达自己的理念,是非常酷且值得尊重的。
voidmnwzp
2023-09-01 05:00:17 +08:00
给中国人用的就写中文,全球通用的 比如轮子之类的就用英文 我就是这样的
iintothewind
2023-09-01 05:10:11 +08:00
默认肯定得是英文文档,然后在考虑中文文档,毕竟技术文档,英文更方便传播。
baobao1270
2023-09-01 06:19:27 +08:00
我会提供中英双语,但是优先英文( README.md 是英文,README_ZH.md 是中文)
begeneral
2023-09-01 07:12:28 +08:00
有啥区别,甲骨文都行
kongkx
2023-09-01 07:24:11 +08:00
klo424
2023-09-01 08:31:50 +08:00
现在都 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.
tairan2006
2023-09-01 08:34:45 +08:00
如果是给国人用的项目,当然还是中文优先

如果跟国别无关,一般优先英文
themelody0
2023-09-01 08:39:35 +08:00
我曾经见过多次有用中文 README 被喷的
EatMi
2023-09-01 09:07:02 +08:00
@begeneral #73 硬要说确实也没啥区别,影响不大。但不可否认这些东西还有会有一些意识形态的因素在里面的,只是想和大家理性讨论讨论哈,可以理解为纯粹是我的好奇,看看大家的想法
chinaguaiu
2023-09-01 09:24:30 +08:00
很多中文项目自己刷星然后卖课,整个中文用户群体给人的印象瞬间不好了...写英文吧
EatMi
2023-09-01 09:36:46 +08:00
@themelody0 #77 这种情况挺多的,令人不悦😑

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

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

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

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

© 2021 V2EX