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

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

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

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

会考虑很多因素

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

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

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

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

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

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

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

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

5974 次点击
所在节点    程序员
101 条回复
EatMi
2023-08-31 13:30:19 +08:00
中文
EatMi
2023-08-31 13:30:24 +08:00
英文
xipuxiaoyehua
2023-08-31 13:32:45 +08:00
技术类的我会更偏向于使用英文
jstony
2023-08-31 13:34:24 +08:00
看情况,面向的主要是中文受众就中文,面向的主要是英文受众就英文。
artnowben
2023-08-31 13:35:05 +08:00
我在做 dperf 的时候,也考虑过这个问题,最终是中英文都有,英文方便国际化,中文方便国内用户,有中文、英文切换的链接。
https://github.com/baidu/dperf/
EatMi
2023-08-31 13:35:34 +08:00
@jstony 确实这样简单粗暴,但是如果两方面都有受众呢,你会更倾向于哪种
jstony
2023-08-31 13:36:06 +08:00
@EatMi “主要”
EatMi
2023-08-31 13:36:14 +08:00
@artnowben 嗯,我看你的首页也是采用了英文,然后加上中文链接
artnowben
2023-08-31 13:36:45 +08:00
dperf 最终只会用英文,维护中英文太费精力了
zhangxh1023
2023-08-31 13:37:20 +08:00
英文写的够好,自信,就优先英文 😂
kdwnil
2023-08-31 13:37:46 +08:00
自娱自乐的项目懒得翻译/仅面向中文用户(比如外语翻译成中文)用中文,其余用英文然后随缘附加中文 readme
EatMi
2023-08-31 13:39:00 +08:00
@jstony 了解你的意思,谢谢。有时候我确实会难以判断出,项目的“主要”受众是哪边。但是看大多数这种情况下,会采用英文作为首选,然后附上中文链接
EatMi
2023-08-31 13:40:35 +08:00
@xipuxiaoyehua 好像确实大多数也是这样,就比如国内一些大厂的开源项目,除非是很“鲜明”地面向国内用户,一般的技术项目都会采用英文首选
EatMi
2023-08-31 13:41:54 +08:00
@zhangxh1023 以前可能确实有英文水平这个问题在,但是现在有了 ChatGPT 的加持,自己再稍微改改,写出一份质量不错的英文文档不算特别困难
EatMi
2023-08-31 13:43:12 +08:00
@artnowben #9 确实,我现在文档体量还很小,但是每次改动都要改两份,也觉得挺费劲的
EatMi
2023-08-31 13:44:07 +08:00
@kdwnil #11 了解,谢谢!其实就还是在**乐观**情况下,更倾向于英文首选 + 中文链接
EatMi
2023-08-31 13:46:16 +08:00
@artnowben #5 哇,刚注意到,是百度的大佬呢。公司内部在做这种项目的时候,关于英文首页还是中文首页,会有相关规定吗?还是说全凭开发者习惯
artnowben
2023-08-31 13:57:31 +08:00
@EatMi 倾向英文
kongkx
2023-08-31 14:02:15 +08:00
中英写在一个文件里面如何
cnbatch
2023-08-31 14:04:54 +08:00
目标用户是中文用户的话,就用中文 + 英文链接;否则就英文 + 中文链接。

到目前为止,我个人的项目都明确考虑过用户群,所以不会在中文还是英文浪费过份的时间

至于我工作时公司的项目……都是内部使用的,不对外开放,说出来没意义。

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

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

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

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

© 2021 V2EX