标题用词不妥。
至少对于 abo-abo 的“指控”是不实的，分明他的文档写得很详细。
我所见的大多数包都有写文档。不管是出于要发布到 melpa 的目的，还是便于自己日后维护，作者都有足够的动机去“自觉”写文档。
我倒是认为应该提倡书写“用户友好”的文档。
对于初级用户、或者不了解项目背景的用户、或者无暇阅读源代码的用户，一张截图／一个范例胜过千言。
1 个赞
好的. 标题已经添加上 “用户友好”
你们不要把楼主吓跑了
提倡就好了，不要“自觉”，这个词很不礼貌。
好的, 标题去掉了自觉.
放心, 我有一颗大心脏, 耐心值无限, 谁也吓不跑我.
4 个赞
没感觉我找错人, 我并不会因为 abo-abo 是大神, 突然就改变我的观点.
我依然觉得 abo-abo 的 org-download 的文档写得不够好, 在他首页贴出的 6 个项目, org-download 文档是最省略的.
你这个举证是没有逻辑的, 一个人并不因为他是大神, 就天然地想写"用户友好"的文档. 即使不友好, 就因为是大神就自动变好. 只不过相比于其贡献, 我们可能可以对大神有更大的宽容度.
2 个赞
关于这一点, 我想引申一下, 伸手党也有其价值, 提供了 用户基数和营销价值, 用户基数做上去之后, 总有一些伸手党会有概率转化为非完全伸手党.
好比游戏当中的非付费用户, 为游戏提供用户基数, 并且为付费玩家提供了陪玩服务. 然后非付费玩家到处鼓吹游戏好玩, 在互联网给游戏提供了营销价值, 相当于免费广告. 时间足够长了之后, 非付费玩家有一部分就转化为付费玩家.
从这个角度来说, 拥抱伸手党, 有利于 emacs 的推广和发展.
1 个赞
文化不一样，不用强求吧。
README写不好的项目也没多少人用，但是并不代表作者有问题。
我的建议：README写得好是作者自己重视用户，README写不好也可以发PR啊，帮助作者改进。
2 个赞
我加了个声明, 我也不认为插件作者有问题.
abo-abo的文档是很不错的，至少比我写的详细多了😂