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

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

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

12923 次点击
所在节点    分享发现
144 条回复
hyy1995
2022-01-19 20:52:39 +08:00
不知道楼主是不是入行不久哈……


我就 4 年研发经验,说久也不久,但深感程序员这个行业的下限有多低,不会思考的伸手党、工作几年技术菜到你想象不到的人,真的太多太多了。做开源的一定“深受其害”,这种语气接地气,我觉得一点毛病也没有,比起某些企业的 KPI 项目充满一堆自造词语、让人一头雾水,要强很多
ByZHkc3
2022-01-19 20:59:04 +08:00
为啥我觉得很贴心?你要是做过项目答疑的话,就知道用户是有多傻逼了。
wccc
2022-01-19 21:01:52 +08:00
可以尝试做一下开源
learningman
2022-01-19 21:03:06 +08:00
When computer sciense expert write 'user', they mean idiots.
alexkkaa
2022-01-19 21:05:06 +08:00
作者的行文确实让人觉得有点刚, 不过我相信它的目标阅读者不会有任何不适
a154312237
2022-01-19 21:09:48 +08:00
我觉得挺搞笑的
作者为小白考虑已经非常 nice 了
作为小白有些文档看的一头雾水 很多时候请教下作者能收到回复的也不多
a154312237
2022-01-19 21:10:40 +08:00
⬆️搞笑指文档作者措辞有幽默感 褒义
Tyuans
2022-01-19 21:20:09 +08:00
可能你没有遇到那种连解压都不会的人来问。
xdeng
2022-01-19 21:39:32 +08:00
你是站在你懂的方式看,很多小白还是很感激这种提示的。
yaoyao1128
2022-01-19 21:41:56 +08:00
因为不懂的人太多了啊……
并且还有各种不懂就写 issue 的
Felldeadbird
2022-01-19 21:49:05 +08:00
楼主试下写一款工具,当你接触到一定群体,你就会觉得这份文档说明是完全没有一点毛病。
Cielsky
2022-01-19 21:53:39 +08:00
我感觉已经很客气了。
可能是被小白问烦了吧。
毕竟很多小白用你的东西还觉得他是大爷你得伺候着
tomczhen
2022-01-19 21:58:07 +08:00
付费了没?捐助了没?贡献了没?
要是都没,这个项目对我有用,我觉得作者跟我比起来确实是人上人。
ncepuzs
2022-01-19 22:35:30 +08:00
下次请连带链接( https://boson.v2mcdev.com/devenvironment/setup.html )一起提供,不然别人怎么判断作者说的对不对。就这里,我觉得作者这么说没什么大问题。
Aixtuz
2022-01-19 23:09:38 +08:00
看看交通法规的内容?你会发现那里面强调的内容更过分。
为啥会强调呢?因为总结这些经验所付出的代价太沉重。
rpman
2022-01-19 23:19:38 +08:00
我第一次装 forge 的时候应该还是个中学生
Jooooooooo
2022-01-20 00:03:34 +08:00
你被 100 个装了 jdk 7 的人追着问了好几个月也会这么写的.
huntagain2008
2022-01-20 01:18:40 +08:00
我作为小白很喜欢这种注意事项很详细的文档。某开源 BBS 的文档开篇讲安装,使用方法没有,最后用“爱用不用”作为结束语给我一种开源大佬很霸气的感觉还有“这项目真能用吗”的疑问。
kuangwinnie
2022-01-20 03:51:59 +08:00
如果是 mc 启动器的文档,你要知道用这个包,试图安装这个包,甚至试图开发这个包的朋友;

可能字面意义上,真的是未成年的小朋友。
GeruzoniAnsasu
2022-01-20 05:00:11 +08:00
因为这个文档真的会有 6 年级小学生来看




我也会这么写。

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

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

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

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

© 2021 V2EX