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

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

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

12843 次点击
所在节点    分享发现
144 条回复
zoharSoul
2022-01-19 15:46:21 +08:00
因为小白太多了
cairnechen
2022-01-19 15:47:05 +08:00
说实话,我感觉这算客气的了
kera0a
2022-01-19 15:47:41 +08:00
有没有可能他只是实话实说呢
Issacx
2022-01-19 15:47:47 +08:00
我觉得还挺贴心。不需要的不看就是。
fgwmlhdkkkw
2022-01-19 15:47:59 +08:00
mc 的启动器吗?
Leonard
2022-01-19 15:50:48 +08:00
其实还好了,把用户(这里指读文档的人)当成小白是比较保险的做法。因为受众水平本来就参差不齐,你觉得不需要的略过就行了。
cmdOptionKana
2022-01-19 15:52:42 +08:00
有一个关键点:他们的主要读者是些什么人,会不会真的以小白为主呢?
dqzcwxb
2022-01-19 15:54:52 +08:00
他说的不挺好的吗
写详细点被骂,写笼统也要被骂,那下次他不写了你来写?
memedahui
2022-01-19 15:55:39 +08:00
文档写的非常棒,就连会发生的错误也写,我觉得完全没问题.
yuhangch
2022-01-19 15:56:23 +08:00
求个楼主头像来源
heyjei
2022-01-19 15:56:59 +08:00
目标读者清晰,赞!
wolfie
2022-01-19 16:00:20 +08:00
看不懂点这里 ❌❌
菜逼点这里 ✔✔
coderluan
2022-01-19 16:00:51 +08:00
这种情况确实不好,骂的人其实并没有完全得到发泄或者彻底避免问题,路人还会感觉作者态度不好,所以我有了个突发奇想:

可以弄个新的开源协议,简称 FYL ,全称大家懂的,该协议和主流协议兼容,主要就是额外规定,你要是打算使用这个开源代码,就要忍受作者的脏话和侮辱,包括不限于代码文档和注释,当然你可以选择不用,用了就不要抱怨作者的态度不好,抱怨只能说明你没做好使用该协议的思想准备。
vanton
2022-01-19 16:02:35 +08:00
按照我的经验,这个已经很客气了。
很多用户会提出一些完全不知所云的 issues ,你要回复就是浪费大家的时间。
vanton
2022-01-19 16:03:58 +08:00
不过这个文档有些错误,比如“介于”应该是“鉴于”
MaMimi
2022-01-19 16:05:37 +08:00
@cairnechen 那还是我看的太少了
Kinnice
2022-01-19 16:05:51 +08:00
# 小白教程
1.xxxx,xxxxxx
2.yyyy ( xxxx 链接)

# 老手教程
自行理解,不懂直接啃代码,若没有代码自行反编译理解
MaMimi
2022-01-19 16:05:59 +08:00
@kera0a 我怀疑你在说我, 但是我没有证据
Shura
2022-01-19 16:06:22 +08:00
楼主是配置失败了,然后感觉被作者侮辱了吗?
cmdOptionKana
2022-01-19 16:07:07 +08:00
@coderluan 然后就会有人发帖问:我承认这个项目的作者辛苦了作出了贡献,但他为什么要采用这种充满内心戏的中二病协议?

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

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

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

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

© 2021 V2EX