这是一个创建于 820 天前的主题，其中的信息可能已经有所发展或是发生改变。
我承认他们费心费力维护文档用爱发电, 但是这个语气为什么一定要这样, 有种小学 6 年级学生和 1 年级学生讲话时的内心戏的感觉
第 1 条附言 · 2022-01-19 16:58:14 +08:00
没有谁否认这是一份写的详细, 容易读懂的文档, 只是觉得作者有些东西没有必要一而再的强调
第 2 条附言 · 2022-01-20 11:20:07 +08:00
有些老哥可能误会了我因为配置失败, 把自己代入到作者所说的“鉴于目标读者的水平”, 毕竟能上 v2 配置个 gradle 代理也不是什么难事. 实际上我想表达的是#38 @acmore 所说的: “都做了那么多了，何必在这里选一个有可能不招人喜欢的说法呢。”, 标题的用语过激是我的错, 我还是很感谢作者写的文档.
144 条回复 • 2022-04-27 18:13:11 +08:00
 |
101
chengy 2022-01-20 10:05:41 +08:00
用别人的东西，没有感恩的心，反而在其他平台上批评别人，原作者知道会怎么看；我建议可以直接和作者沟通，说你看的不爽，然后给方案，提交文档 patch
|
 |
102
zjddp 2022-01-20 10:09:27 +08:00  2
@MaMimi 22# forge 啊，那正常，这个文档面向的群体确实有很大一部分是啥也不懂的零基础纯小白
不必把自己带入这个群体里面，配失败了就从头再来一遍，毕竟你能在 v2 发帖子 另外人上人这个事，也不必有这种想法，费时费心维护中文文档换来的是什么？ 放下筷子骂娘这事别干，真的 |
 |
103
idealhs 2022-01-20 10:10:38 +08:00
介于作者的目标水平，这种文档没什么卵用🐕
|
 |
104
zw1one 2022-01-20 10:11:25 +08:00
小白问的无意义的浪费时间的问题太多了呗，读者水平是很难预测的。
|
 |
105
dreamage 2022-01-20 10:19:50 +08:00
不想看可以 ALT+F4 不想用可以 SHIFT+DEL
|
 |
106
ClericPy 2022-01-20 10:20:18 +08:00
你不是他, 又怎么知道一个开源作者每天收到多少白瓢小白颐指气使的垃圾邮件? 直接改成英文文档, 少发生很多事
确实已经算客气的了 |
 |
107
fareware 2022-01-20 10:24:45 +08:00
大部分人的确是又白又憨......
|
 |
108
hutoer 2022-01-20 10:39:56 +08:00
还是宽容点吧
|
 |
109
0xZhangKe 2022-01-20 10:44:32 +08:00
因为有些人的水平甚至没耐心看完这份文档。
|
 |
110
Thinginitself 2022-01-20 10:47:52 +08:00
他语气确实不是很好；我觉得可能太多人烦他了吧，他语气差点影响不是很大~
|
 |
111
aerzha 2022-01-20 11:10:17 +08:00
1. 人员水平参差不齐，有老鸟，有小白
|
 |
112
weichengwu 2022-01-20 11:23:38 +08:00
“介于目标读者的水平，这里有。。。”
替换成 “小白用户请参考。。。” 感觉会好很多 |
 |
113
fyxtc 2022-01-20 11:40:56 +08:00
真的，我说真的，也许作者真的是好心指出来，避免一些真小白去选择困难的方式。从我的角度看，这种描述没有任何问题，反而是很好的文档。只能说人都习惯于给自己加戏，也给被人加戏。
|
 |
114
reiji 2022-01-20 11:59:41 +08:00 via Android
确实不友好，但是不算攻击性和优越感
|
 |
115
18000rpm 2022-01-20 12:16:45 +08:00 via Android
迫于系列
迫于我国喜欢拜大佬的风俗，有点能力的普通人总是会被供着捧着当老爷当皇帝，被迫当人上人 |
 |
116
leimao 2022-01-20 12:23:35 +08:00
不给 Docker 的下场就是这样，作者被人记恨，用户很不爽。
|
 |
117
xmuli 2022-01-20 12:26:42 +08:00 via iPhone 1
自觉人上人的人，是不会来写文档的。。吧！！
|
 |
118
fengfisher3 2022-01-20 12:28:36 +08:00
作者写的都是大实话呀。感觉作者太难了，照顾使用者的技术水平，还要照顾好他们的情绪。
文档是写给大家看了，不是专门写给你看的。 |
 |
119
nicevar 2022-01-20 12:29:56 +08:00
所以没事不要免费提供服务，这都会被喷，如果你自己去弄就知道了，一些人一点基础没有，你一年 365 天回答他们的问题都不够。
|
 |
120
yhxx 2022-01-20 12:34:04 +08:00
这个文档还可以吧
你看尤雨溪那态度才是真·人上人 |
 |
121
dangyuluo 2022-01-20 12:47:14 +08:00 1
这人语气简直有病，读了这么多中文英文文档了，还真是头一次见到这么拽的。。
|
 |
122
MoRun 2022-01-20 13:53:30 +08:00
楼主你帖子的语气不跟这作者一样的
所以算是同行相轻吗😂 求同存异呗 |
 |
123
kingmo888 2022-01-20 13:58:10 +08:00
假定一下哈，
作者被一大堆问题已经弄得很烦了，带着这种认知，还是出了一个简便的一键安装包…… 使用者——有点水平没出错的：擦。。什么鬼。 使用者——出错的：大佬，你看我这一键安装包下的对吗，为什么安装上还是有问题。。。 总之啦，免费的东西，不要要求服务，对服务没要求了，态度也就无所谓了。 付费的东西，不给你好脸你还是要较真一下的。 免费的东西，又对你有帮助，你计较人家这么多干啥呢。 |
 |
124
EnochZack 2022-01-20 14:17:02 +08:00 via Android
这种文档一般都是把读者当成小白，并没有区分哪一波人，因为即使是经验老手也会在配置过程中翻车，完全没必要在意文档的口气，只要没有出现脏话，那么他的出发点都是希望你尽快的运行起他的项目
|
 |
125
wellsc 2022-01-20 14:19:38 +08:00
还挺敏感
|
 |
126
SmiteChow 2022-01-20 14:45:36 +08:00
你不是他的目标用户
|
 |
127
jessun1990 2022-01-20 15:13:30 +08:00
感觉掺杂太多个人情感在里面。
技术文档应该是中立的，完全可以写成“如果你在配置 xxxx 遇到了困难，可以先阅读 xxx 教程来熟悉前置步骤”balabala 。看看国外的文档，最多是“我们强烈建议 xxxx”。 至于伸手党和小白党，完全可以另外写一个 issue ，集中去吐槽。 总之，技术 /教程文档应该和个人情感表达分开。 |
 |
128
imn1 2022-01-20 15:59:21 +08:00
不知道现在如何，我当年大学语文是选修，几乎没人报
说明文性质的文章，用词是需要平白和中性的，个人情绪、带感情色彩的词应该写到记叙文里面 同样，论文和辩论不是一回事，想“以理服人”就需要保证中性和合理，辩论则不同；因为辩论中证明自己对不是唯一点，证明对方错同样也是重点(可以带入批判用词)，而论文重点是证明一个理论的正确性 感觉很多理科生没有注意这些（我这算“人上人”么？哈哈） |
 |
129
iovekkk 2022-01-20 17:27:14 +08:00
今天看到一个视频，主要内容是讲，为什么大部分的电话诈骗的骗子，普通话都非常不标准
原因竟然是听到不标准普通话的诈骗话术，依然不会怀疑的人群，才是他们的目标人群 |
 |
130
Themyth 2022-01-20 18:25:29 +08:00
我见过比这个用词还过分的。。。
这个算温柔的了。。 |
 |
131
SuperMild 2022-01-20 18:52:39 +08:00
一方面，现实生活中，有的人就是对语气不敏感，是无心的，想到什么就说什么，比如专业人士对行外人，可能会来一句“这个事情说深入了你也不懂，我就不细说了”，敏感的人可能听了不舒服，但不敏感的人完全感觉不到有啥问题，有时甚至会说“停停停，你不用说原理我听不懂，直接告诉我操作步骤就行，越简单越好”。
另一方面，人也有不同的性格，有的人很圆滑，或者情商很高，或者很体贴别人的心情。但也有的人棱角比较尖锐，说话可能容易得罪人，但只要他做的是好事，不在背后搞人，也很难指责他什么吧？ 就我自己的感受，说话容易得罪人的人让我更安心，看起来更安全；反而遇到一些说话毫无破绽的，我会更难和他拉近距离，因为他会藏住情绪，万一我得罪了他他也不会表现出来，这就很可怕。 |
 |
132
ScepterZ 2022-01-20 18:55:48 +08:00
你能看懂，所以你有点生气，其实那种目标用户被骂无所谓，只要能用就很开心了
|
 |
133
msg7086 2022-01-20 19:18:11 +08:00 via Android
|
 |
134
littlewing 2022-01-20 20:17:12 +08:00 1
因为小白太多了，而且总有人不看文档，伸手就问怎么回事，为什么，恨不得你帮他搞好，不配合他还骂你
|
 |
135
idrawer 2022-01-20 21:28:20 +08:00
中文使用者大多数这样缺乏良善的劣质人
|
 |
136
zhensjoke 2022-01-20 22:35:06 +08:00
没弄过大众化的产品吗。。
有些客户用的让你想骂娘 |
 |
137
96368a 2022-01-20 23:24:50 +08:00 via Android
第一眼看到这语气确实有点不爽，仔细思考一下发现这样写还蛮好的，可以直接劝退小白，目标读者自然也不会在乎这种问题，我以后也这样写😄
|
 |
138
7gugu 2022-01-20 23:36:17 +08:00
因为确实会有啥都不懂的，一上来就问环境怎么装😂
|
 |
139
Youkochan0v0 2022-01-21 01:04:47 +08:00
虽然低级问题非要伸手来问的确实让人抓狂，有怨言太正常了，但感觉直接把这种话写在文档里不是成熟的作风。
不过，某些直接怼部分用户的更直白更口语化的骂声我反而还更能接受一点，感觉作者有本领也真性情， 但像这样反复阴阳怪气的确实观感很差。不管我是不是小白有没有顺利部署都会对作者印象不佳。 |
 |
140
cmdOptionKana 2022-01-21 08:17:18 +08:00
|
 |
141
dianso 2022-01-21 13:28:56 +08:00
估计是湾湾或者湾湾粉
|
 |
142
cyberpoint 2022-01-22 23:10:19 +08:00
这个年代，说实话就是错。
|
 |
143
acadminn 2022-01-23 00:17:39 +08:00 via iPhone
我觉得，文档写详细点没问题呀，就是会有小白问一些小白的问题，把小白引流引走，当然自己是小白就按作者写的来呗，各取所需，多一点这样愿意多写一两句话的作者，小白就会少问点傻逼问题，开源项目氛围才会越来越好
|
 |
144
MEIyiyi 2022-04-27 18:13:11 +08:00
有文档就是叔
|
Select Language