A help button could be useful either way
15 个赞
We had this button on Stack Overflow and the analytics / data showed that almost nobody used it. That does not mean it should not exist, of course, but the general rule is that the type of people you would want to use this button, pretty much never do.
4 个赞
Stack Overflow seems way more aggressive these days for brand new users and audience for Discourse is way wider so this kind of approach may be applicable
I think there is definite value in giving some extra tips for tl0/tl1 that are getting accustomed and also for more advanced users that are looking for secret magic.
I guess what I want a little is a help mode that goes away after a bit
6 个赞
To be fair, there is a plugin that sort of permits this already and I don’t think a lot of people use it…
https://github.com/cpradio/discourse-plugin-composer-help-button
Granted, it isn’t right aligned, but it gives people a way to add customize help for the format bar should they deem that a necessity.
7 个赞
Also, this was written before the new outlet (that Canned Replies uses) to display help text at. So it could be improved to use that same location instead of a modal now (if someone has the time PR welcome).
Right-aligning the button might require a new outlet or a new option to the toolbar component (PR welcome for that too).
But those would be the only necessary improvements to make it meet the UI mock ups above.
3 个赞
None of that is new; I worked with Ben to add that in 2010/2011. See proof here…
4 个赞
Yeah it fealt eerily familiar. I guess I think there is merit for a help mode that kicks out once you posted a bit
But sure this can be plugin territory, agree that for seasoned users a help button is largely noise
2 个赞
For what it’s worth, I appreciate the comfort of being able to find some kind of formatting help, even if it’s rarely used.
It’s good for bootstrapping new users unfamiliar with markdown (like communities coming from more bb related forms, or with wysiwyg editors), and a nice reminder for when I just can’t figure out how how to do something simple like code formatting, and have been deep in JIRA or Sharepoint or something with vastly different formatting options.
7 个赞
发布一个关于类似内容的更新的请求 - Hard to find the Markdown help button
3 个赞
我的看法是：
新手不太了解如何使用 Markdown 功能。
提供 Markdown 帮助可以让新手用户更容易地学习 Markdown。其他用户也发布过 Markdown 帮助内容。我认为拥有此功能会很有用，因为它有助于提高易用性。
作为替代方案，我们也可以在顶部添加更多 Markdown 按钮供新手使用。然而，这样做的问题是它会使布局更加混乱。
2 个赞
我也认为将此部分（工具栏）添加到 New User Tips 会是个好主意，正如 Jeff 在上面提到的那样。
附带简短描述和一个可配置的链接。它可以指向关于格式设置的独立主题，例如 Understanding Discourse for new users
或者可以直接指向 Markdown 帮助 Markdown Reference
4 个赞
用户看到：
在此处键入。使用 Markdown、BBCode 或 HTML 进行格式设置。
好的，他们可以使用 Markdown、BBCode 或 HTML，但发现有些东西不起作用，
而且其他用户使用的一些他们不知道的东西却有效。
所以有不同版本的 Markdown、BBCode 或 HTML。
因此，在帮助中，Discourse 应该说明是哪些版本。
或者，而不是那样，只需列出 Discourse 使用标记项的完整列表。
或者至少有一个指向其源代码所在位置的链接。
但普通用户无法理解该源代码，
所以最好还是有一个完整的列表，或者称之为备忘单，
列出 Discourse 实现的标记运算符。
2 个赞
[details=summary][/details] 语法在哪里有文档说明？
- 如上文所述，它没有在任何页面中提及，因为它是一个自定义的 Discourse 功能。
- 在 meta 上搜索“
[details]” 显示它确实存在，并且可能被描述为“隐藏”，但没有提供关于摘要语法如何工作的线索。 - 在网上搜索显示了 discourse-details 仓库，但现在它不包含任何信息，只有*“插件已弃用，现在是 Discourse 的一部分”*。
- 我最终在 Details in topic styling changes - Feedback 中找到了它。但这并不是我期望用户学习语法的地方。
我真的很希望有一个帮助按钮链接到某种官方文档……
这是 discobot 教程的一部分
1 个赞
有一个 discobot 教程吗？我使用并推广 Discourse 已经很多年了，但从未遇到过这个，或者认为它是一个学习如何使用 Discourse 的地方。即使现在，我（看着我们的 Discourse 实例）也不知道如何运行它。
我以为我一定错过了什么，或者 discobot 是在我刚开始使用 Discourse 之后才引入的，所以我去了 https://meta.discourse.org/t/discourse-new-user-guide/96331。那里没有提到 discobot 教程或 [details]。有一个 Markdown Tutorial - Introduction 列出，但仅用于 common mark。
@pfaffman 我现在在齿轮图标下看到了那个选项。不是我不会点击齿轮，而是我认为我知道齿轮的含义——更改设置。（我错了。）再加上我假设可能有一整套 Discourse 特定的功能，比如 [details]，我确信它们不会都列在一个隐藏的菜单下，所以我开始寻找手册。
如果有一个按钮明显是用于帮助的（例如问号），我肯定会点击它。如果有一个按钮明显是用于插入东西的，我也会点击它。我只是下意识地说服自己，它不可能是齿轮……
也许我是老派了，但我真的很想有一个权威的来源可以阅读，在那里我可以学习所有功能并将来参考。这样的东西存在吗，还是通过机器人学习是新趋势？
1 个赞
在 Discourse 站点上创建一个新帐户。
除了在此处关注公告外，别无他法。我们已加大努力在此文档 Documentation - Discourse Meta 中记录内容，但我不知道这是否感觉权威。
谢谢。所以如果我创建一个新帐户，我确实会看到 discobot。但是，对于像我这样在 discobot 开始之前加入的用户来说，与它互动的方式非常令人困惑。这可能有点离题，但突显了可能需要一个帮助按钮，所以我将在此处继续讨论。如果您认为合适，请随时移动或将我引导到更好的主题。
在我新发现 discobot 后，我尝试在我们的网站上使用它。根据各种讨论和提及，我期望我应该能够以某种方式在某处键入 @discobot start tutorial 来学习……
- 我在一个网站的站点聊天中尝试了这一点。什么也没发生。我尝试初始化与 @discobot 的个人聊天，但找不到它。
- 然后我尝试向 discobot 发送一个“个人聊天”。我做不到。
- 在我们的一个网站上，我能够将 discobot 添加到我的个人聊天列表中，但要求它“开始教程”没有任何效果。
- 最后，我在这个网站上创建了一个新帐户，并受到了机器人的欢迎，这清楚地表明应该有一个关于我与机器人互动的帖子（并且我应该收藏这个帖子）。
现在我看到我可以在我们的网站上搜索 discobot，转到它的用户页面，然后给它发消息，令人困惑的是我需要输入一个长标题和一些内容。最后，在创建此消息后，我可以要求它“开始教程”。
为什么这么难？为什么机器人不响应在聊天或私人聊天等中开始教程的请求？如果有人在网站上开始时跳过了通知设置而没有注意到 discobot 怎么办？他们以后如何获得帮助？
我不知道最佳解决方案是什么，但某个地方的帮助按钮可以引导我完成这个过程，那将非常有帮助。
1 个赞
您是否在设置中禁用了 Discobot？您是否运行的是非常旧的 Discourse 版本？
1 个赞