Discobot 新用户教程:为预格式化文本添加步骤

Discobot 的新用户教程已经通过以下文本处理了粗体 + 斜体格式以及引用格式:

discourse_narrative_bot.new_user_narrative.formatting.instructions
discourse_narrative_bot.new_user_narrative.quoting.instructions

由于在我们的论坛中,用户经常发布日志文件或控制台输出,而新用户往往使用引用格式代替预格式化文本格式,或者完全不使用任何格式,因此在新用户教程中引入预格式化文本的说明将非常有益。

我已经查看了上述说明文本,但简单地添加一些关于预格式化文本的说明似乎并不合适,因为 Discobot 本应真正检查用户是否正确执行了格式设置(而目前 Discobot 尚未做到这一点)。

我该如何为 Discobot 的新用户教程添加预格式化文本的说明,并确保 Discobot 能够实际检查用户是否正确完成了格式设置?

1 个赞

我建议前往 /admin/customize/site_texts/,搜索 js.composer.reply_placeholder(或“在此输入。使用 Markdown、BBCode 或 HTML 进行格式化。”),并将该文本修改为类似:

在此输入。使用 Markdown、BBCode 或 HTML 进行格式化。拖拽或粘贴图片。在代码块前后使用 ```。

毕竟,真正完成教程的人寥寥无几。虽然他们可能会注意到这个占位符,但大多数人仍会盲目地粘贴内容。

1 个赞

我一开始也是这么想的,但正如我上面所写:那样的话就无法检查用户是否真正应用了预格式化文本格式。他完全可以完全省略这一步,却依然收到“做得好!”的回复。

在我们的论坛可不是这样:过去 14 天里,27 位新用户中有 14 位完全走完了教程。

2 个赞

这不算是个坏主意,但真正“需要”代码格式化的情况其实比较少见——我们在高级教程里有提到吗?我觉得那里才是它该出现的地方。

我也非常赞同 @pfaffman 关于编辑默认占位符文本的建议。

最终,你可能得采取我们最终在 Stack Overflow 所做的做法:尝试检测以未格式化形式粘贴的代码,如果看到帖子中包含过多“类代码”文本,则拒绝该回复——关于为此开发插件的讨论可以在这里的 meta 版块找到。

1 个赞

代码格式化是一项非常基础的操作,用户从第一天起就需要掌握。因此,在我们的论坛中,它不应出现在高级教程里,而应放在基础教程中。

随着 Unformatted Code Detector - #27 by codinghorror 已准备就绪,现在是否有可能