你好,我是一只喜欢水贴的猫猫 。
1 个赞
联动:
我觉得主要原因在于,官方作为开发者自然是完全理解该如何正确使用,然后在文档里使用自己认为恰当的描述。但是用户各人的水平不尽相同,即使看了详细的解释性的语句也有可能误解。文档作者和读者之间知识上差距导致的这一问题。
举最近的例子:
onebot的selfId
配置项描述写着 机器人的账号 ,其实不应该出问题,但是我们看到了 自助姬器人 。我自己是有过nonebot的使用经验的,没有出这种错。写成 机器人的QQ账号 会不会更好?
现在我看Koishi的各种文档,我明白是没有问题的。但是我一开始是完全没有接触过js还有ts的,看着正确的文档,但是完全不知道在说什么。(就好像让小学生看高数
是不是在写文档的时候,默认读者没有任何相关知识比较好呢?实际上有问题的用户也确实多半是没有很丰富的经验。我在工作的时候写给新人的文档就是把读者当成超级大笨蛋的,每一个操作都用截图并用红圈标注我做了什么。
1 个赞
喵喵喵~
2 个赞
医治不死病,佛度有缘人
保证绝大多数的人明白就行了
(实在不行把看不懂的开除人籍(雾))
1 个赞
坐等更新.jpg
1 个赞
如果你认为这样更好,可以自行 fork 一份 onebot 插件并发布到插件市场。
很遗憾,由于某些不可抗力,Koishi 官方永远不会提供 QQ 登录的支持(包括 onebot 插件)。如果你现在能用 onebot 插件登录 QQ,那是因为某些第三方库提供了这个能力。在可以预见的未来,任何官方插件中都不会出现 QQ 相关字样。
3 个赞
是啊 我的更新呢
1 个赞
别急 会有的
2 个赞
所以下面没有了是吗
edited
我好歹要看到现象长什么样吧,除错方法和结论和过程一个都没看到,我怎么评价
2 个赞
此外,标题很有趣
2 个赞
别急 会有的
1 个赞