我是一只闲聊吹水分区的猫猫

你好,我是一只喜欢水贴的猫猫 :cat:

1 个赞

联动:

我觉得主要原因在于,官方作为开发者自然是完全理解该如何正确使用,然后在文档里使用自己认为恰当的描述。但是用户各人的水平不尽相同,即使看了详细的解释性的语句也有可能误解。文档作者和读者之间知识上差距导致的这一问题。

举最近的例子:
onebot的selfId配置项描述写着 机器人的账号 ,其实不应该出问题,但是我们看到了 自助姬器人 :smiling_face_with_tear:。我自己是有过nonebot的使用经验的,没有出这种错。写成 机器人的QQ账号 会不会更好?

现在我看Koishi的各种文档,我明白是没有问题的。但是我一开始是完全没有接触过js还有ts的,看着正确的文档,但是完全不知道在说什么。(就好像让小学生看高数

是不是在写文档的时候,默认读者没有任何相关知识比较好呢?实际上有问题的用户也确实多半是没有很丰富的经验。我在工作的时候写给新人的文档就是把读者当成超级大笨蛋的,每一个操作都用截图并用红圈标注我做了什么。

1 个赞

喵喵喵~

2 个赞

医治不死病,佛度有缘人
保证绝大多数的人明白就行了
(实在不行把看不懂的开除人籍(雾))

1 个赞

坐等更新.jpg

1 个赞

如果你认为这样更好,可以自行 fork 一份 onebot 插件并发布到插件市场。

很遗憾,由于某些不可抗力,Koishi 官方永远不会提供 QQ 登录的支持(包括 onebot 插件)。如果你现在能用 onebot 插件登录 QQ,那是因为某些第三方库提供了这个能力。在可以预见的未来,任何官方插件中都不会出现 QQ 相关字样。

3 个赞

是啊 我的更新呢 :smiling_face_with_tear:

1 个赞

别急 会有的

2 个赞

所以下面没有了是吗

edited

我好歹要看到现象长什么样吧,除错方法和结论和过程一个都没看到,我怎么评价

2 个赞

此外,标题很有趣

2 个赞

别急 会有的

1 个赞