为什么有些文档的作者这么人上人

2022-01-19 15:43:59 +08:00
 MaMimi

我承认他们费心费力维护文档用爱发电, 但是这个语气为什么一定要这样, 有种小学 6 年级学生和 1 年级学生讲话时的内心戏的感觉

12928 次点击
所在节点    分享发现
144 条回复
M2K4
2022-01-20 06:36:50 +08:00
很符合程序员给人的刻板印象
documentzhangx66
2022-01-20 06:41:49 +08:00
我当年本科大一时,带了一些研究生,因为我很小就被几个大佬带着学 IT ,导致我觉得这些研究生贼菜,然后我经常骂人.....直到后来我不懂感情学,被渣女完虐,才开始老老实实向感情学大佬学习,才慢慢理解菜鸟们的感受。

我觉得,写教程,就专心写教程,如果你要考虑读者的水平,做区别化处理,你完全可以好好讨论:入门者请点这里补充一些知识,大佬请跳过啥的。直接在文档里开骂,或阴阳怪气,不是大佬风范。

另外,林子大了,有些人喜欢出来捣乱,在所难免。这个论坛里,我经常会遇到某些人,他们一上来,不会指出你写的东西,具体哪里不对,他们只是发泄情绪,说你写的不对。如果你认真地问他们,哪里写的不对,他们又指不出来,然后继续阴阳怪气。其实这类人,无视就好了。

我在论坛里写东西,主要原因是希望和真正热爱 IT 的人进行交流,同时也能得到一些大佬的指点,比如:

@chenyu8674 帮助我找到我找了很久也没找到的单机 wow.
@msg7086 给了我一个大容量硬盘进行连续 IO 的数据,我曾经一直错误以为大容量硬盘做一次全盘检查需要很长时间,最后在这位大佬的指点下,我发现是自己设备有 IO 瓶颈,等等...

总之,林子大了,啥人都有,习惯就好。取其精华。当你觉得有问题,就认真问一下对方,但当对方只是来撕逼时,你就不要浪费时间了。
msg7086
2022-01-20 07:02:43 +08:00
@documentzhangx66 谢邀,很高兴能帮到你。

正好进到主题了就说两句。
有些东西会变成什么样子,是有他的道理的。你没有站在他的角度,没有经历过人家可能经历过的悲惨经历,你大概率不知道他为什么会这么写、这么说、这么做。

比如说我们字幕组招新。
以前都是考官直接和新人去对接,考察水平然后决定是否通过。
考官自己也要上班,都是下班时间边做片边面试新人。
但经常会遇到一些自负但很菜的新人,觉得自己老牛逼了,被我们刷下去以后就恶语相向。见过追在后面一直问的,见过发邮件发私信质疑的,最强的一个应该是被我们因为一个低级错误刷掉以后跑到知乎洋洋洒洒写了几千字从全方位多角度把我们组连带整个中国字幕组圈子从头到脚喷了一遍的。
所以我们就逐渐从考官直接对接,变成招募了专门的抗压能力强的前台接待男姐姐去对接,一直到现在我们终于决定完全移除真人对话,所有考核内容全部放在网站上,然后邮件联系,基本杜绝了网爆的可能。

如果你没经历过这些年社会的毒打,你肯定会觉得我们为什么要变得这么冷冰冰的没有人情味。如果你没被那些眼高手低的人骂到脑溢血,你肯定想我们为什么要让那些人圆润地转动到远处。
Perry
2022-01-20 08:27:44 +08:00
有可能是作者经常被这些小白问题受到骚扰,所以保险起见加进了 doc 。
loading
2022-01-20 08:46:06 +08:00
建议楼主看一次《提问的智慧》,等你也有一定水平的时候,你会发现那些张嘴就问的人很烦,这个文档的作者可能是以前太热心,现在心烦了。
sidkang
2022-01-20 08:48:39 +08:00
认同,文档的写作方式确实有言下之意的成分,没有必要这样。
shakoon
2022-01-20 08:51:06 +08:00
我搞的某个产品最早只有几页简要说明,后来增加了一些流程图和截图,再后来到去年底大版本升级重写时,已经有五万多字,几百个截图了。原因就是用户的智商真的是没有下限的,要是不写清楚,后续技术支持能把人逼疯
zzc1368129224
2022-01-20 08:52:42 +08:00
被问烦了呗,还能写详细的文档已经很不错了,极端点的直接没有文档或者删库跑路
Vindroid
2022-01-20 08:56:37 +08:00
因为读者水平的高低差确实大,大到你没法想象。当一个人遇到许多不会读文档,啥基础都没有还非得用这类技术向工具,还脸皮很厚一个个配置项追问的时候,你的心态很可能也会像这位作者一样用类似嘲讽的说明写出这段话,虽然这类人会无视你的说明,继续提出一堆明确有说明的问题
juzisang
2022-01-20 09:17:32 +08:00
小白还以为自己是大爷的人还挺多的,Github 有个几十个星星的项目,都时常有人不会装,上来就是发个 Issues 骂你是垃圾,导致我点开那个项目的欲望都没了,时常有这种人的话,帖子里这项目作者的语气已经很好了,要是我直接就开骂,答都懒得给你答。还有,如果你觉得文档不好,你可以自己提个 PR 改一下呗,我相信作者肯定乐意接受
shiguiyou
2022-01-20 09:18:29 +08:00
我看了感觉没啥问题啊...
monospace
2022-01-20 09:22:19 +08:00
这个文档有什么问题?你觉得「有些东西没有必要一而再的强调」,这个项目又不是只给你用,还有一大把各种水平、各种经验的人也会用。作者尽量把不必要的发问和一些常见问题写在文档中,不好么?
superfatboy
2022-01-20 09:34:44 +08:00
看来时没有被小白毒打过
zer0fire
2022-01-20 09:39:57 +08:00
虽然把用户当白痴, 但是他写了很详细的稳定
现实里就是刀子嘴豆腐心
动漫里就是傲娇
aliveyang
2022-01-20 09:43:09 +08:00
作者性格比较直吧,不过文档很详细了
youxiachai
2022-01-20 09:45:05 +08:00
lz 是真不知道其实还真有不少中小学生用户?
kinglisky
2022-01-20 09:45:17 +08:00
那个有文档就已经很好了。。。
sandman511
2022-01-20 09:53:33 +08:00
同意楼主 直接后面放个 idea 链接就行了 还要鉴于读者水平 人上人
Maiiiiii
2022-01-20 09:59:12 +08:00
可以看一下 issues 历史
kujio
2022-01-20 10:03:13 +08:00
看教程的就是小白,不是小白也不会看教程。
既然这样是不是:鉴于读者的识字水品以下课文里不认识的字在课后有标注;鉴于读者的英语水品不认识的单词在课文后有释义;
对于已经确定的对象群体,不用刻意的再强调了,刻意强调虽然可能跟作者性格有关,但确实会令部分人感到不舒服。

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

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

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

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

© 2021 V2EX