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

[MaMimi]

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

[lucybenz]

1 、如果按照文档部署不起来 出错 那就是文档的原因；
2 、这么阴阳怪气的写文档，确实自持优越感；
3 、搞个同类产品 做出更严谨优质的文档干掉他

[efaun]

是有点阴阳怪气了

[MaMimi]

@acmore "都做了那么多了，何必在这里选一个有可能不招人喜欢的说法呢。" 这确实是我最想表达的意思

[yohole]

我觉得要知道作者经历了什么再来评价也不迟，唯心地认为，这文档的描述问题不大，做技术的有点个性无伤大雅的，不是任何事都上纲上线，你看 Linus 在语言上的争议还少么？

[tutu10]

@acmore 有被这个比喻笑到

[GalaxyVIP]

感觉挺正常的啊，也没有不尊重谁吧。说明这个文档的目标读者确实是小白啊，作者也就是多提供了几个途径，免得动不动就伸手党很烦的。

[fatelight]

一而再再而三的给人喂饭,你体验过就不会这样说了

[Mogugugugu]

Forge 的群体有小学生的。。。或者说很大一部分可能都不知道什么是 Java 的 = =

[YaakovZiv]

可能是作者被问一些基础环境问题感到烦了吧，即便给出基础环境需求的组件，还是会有人问基础环境要怎么处理。
题外话：我就遇到过那种让我很难受的同事，同事是五年经验的.net 开发，看文档有三个月了，突然问我一句，文档开头说的 ssh 云主机是啥，我就感到很心累。真想劝他转行。但凡有两年经验的开发，自己查资料的能力得是有的，这个要求不算过分。

[yidinghe]

就是作者内心戏多点而已

[RiceNoodle]

我觉得你的直觉没错，写详细点，和语气没关系，文档没必要这么写的。

[sky96111]

有可能…这个 mod 的大部分受众用户确实在这个水平呢？ mc 这种老少皆宜的游戏玩家年龄跨度很大，甚至可能还在读小学

[cmdOptionKana]

@acmore
@MaMimi

"都做了那么多了，何必在这里选一个有可能不招人喜欢的说法呢。"

我觉得有两个问题：

1. 可能作者只是想到什么就写什么，而不是故意选择一个不招人喜欢的说法。因为每个人的敏感度不同，前面很多楼都说不觉得语气不妥，也许作者恰好也是对语气不敏感的人。

2. 假设作者是故意选择这个说法，也问题不大，因为“做一个彻头彻尾的好人形象”是一种选择，“做一半好人，一般有刺的人”也是一种选择，很难说哪个是更好的选择吧？人有不同的性格。

[kett]

还好吧，毕竟不收费，又有用。

[Latin]

提问的智慧

[c6h6benzene]

写文档不就该当用户什么都不懂来写吗…都懂的话为什么会来打开这份文档？

[lingyan190]

鉴于用户可能在实践中出现各类问题，作者并不方便一一解答，建议使用推荐配置或者离线包。
这样写不好吗？？？为什么非要预想一下水平，再说 git 上面给加星可是能反馈到简历上的，稍微对小白友善点怎么了吗

[lostberryzz]

上个网怎么这么玻璃心呢，不想看关掉就行了，另外 mc 的玩家还真以中小学生为主，文档的作者应该是实话实说，说实话如果我完全不懂技术，看到作者这段话，我只能感觉到很贴心，很为小白考虑。

[sgissb1]

两个原因，因为伸手党太多了，出了问题就是有一定的懒惰思想，总想着别人帮他解决掉，或者最好包圆了。
另一个是“大佬”不在少数，说话做事很多时候只考虑自己的“立场或地位”。

反正看看就好，无所谓的事情了。

[laydown]

这就受不了还是怎么的？我觉得语气没什么问题啊，这么贴心了还得怎么样呢？不是很理解。如果楼主来改写，会怎么写呢？