A help button could be useful either way
15 curtidas
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 curtidas
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 curtidas
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 curtidas
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 curtidas
None of that is new; I worked with Ben to add that in 2010/2011. See proof here…
4 curtidas
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 curtidas
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 curtidas
Publicando novamente um pedido mais recente para algo semelhante - Hard to find the Markdown help button
3 curtidas
Minha opiniĂŁo sobre isso:
Pessoas inexperientes nĂŁo sabem realmente como usar os recursos do markdown.
Uma ajuda de markdown tornaria mais fácil para usuários novatos aprenderem markdown. Outros usuários postaram coisas para ajuda de markdown. Acredito que seria útil ter esse recurso, pois ajudaria na facilidade de acesso.
Como alternativa, também podemos adicionar mais botões de markdown no topo para novatos. No entanto, o problema com isso é que torna o layout mais confuso.
2 curtidas
Acho que seria uma ótima ideia adicionar esta seção (barra de ferramentas) a New User Tips também, como Jeff mencionou acima. 
Com uma pequena descrição e um link configurável dentro. Pode ir para um tópico próprio sobre formatação como Understanding Discourse for new users
Ou pode ir diretamente para a Ajuda do Markdown Markdown Reference
4 curtidas
Usuários veem:
Digite aqui. Use Markdown, BBCode ou HTML para formatar.
Ok, eles usam Markdown, BBCode ou HTML, mas descobrem que algumas coisas nĂŁo funcionam,
e há outras coisas que outros usuários usam que funcionam, mas eles não sabiam.
Portanto, existem diferentes versões de Markdown, BBCode ou HTML.
Então, na Ajuda, o Discourse deve dizer quais versões.
Ou, em vez disso, simplesmente ter a lista completa de itens de marcação que
o Discourse usa.
Ou, pelo menos, ter um link para onde no código-fonte está.
Mas usuários normais não conseguiriam entender esse código-fonte,
Então, ainda seria melhor ter uma lista completa, ou chamá-la de “cheatsheet”,
dos operadores de marcação implementados pelo Discourse.
2 curtidas
Onde está documentada a sintaxe [details=summary][/details]?
- Não é mencionada em nenhuma das páginas referenciadas acima, pois é um recurso personalizado do Discourse.
- Uma pesquisa por “[details]” no meta mostra que ela existe e que pode ser descrita como “ocultar”, mas não dá nenhuma pista sobre como a sintaxe do resumo funciona.
- Uma pesquisa na web mostra o repositório discourse-details, mas este agora não contém nenhuma informação, exceto “Plugin depreciado, agora faz parte do Discourse por padrão”.
- Finalmente, encontrei em Details in topic styling changes - Feedback. Não onde eu esperaria enviar usuários para aprender sobre a sintaxe.
Eu realmente teria gostado de um botão de ajuda vinculando a algum tipo de documentação oficial…
Faz parte do tutorial do discobot
1 curtida
Se você clicar na engrenagem, ela oferecerá para inseri-la para você
Portanto, as pessoas que nĂŁo clicarem na engrenagem provavelmente tambĂ©m nĂŁo clicarĂŁo em um Ăcone de ajuda. 
1 curtida
Existe um tutorial do discobot? Uso e recomendo o Discourse há muitos anos e nunca me deparei com isso, nem com a ideia de que é para lá que se deve ir para aprender a usar o Discourse. Mesmo agora, não tenho ideia (olhando para a nossa instância do Discourse) de como executaria isto.
Pensei que devia estar a perder alguma coisa, ou talvez o discobot tenha sido introduzido depois de eu ter começado a usar o Discourse, por isso fui a Understanding Discourse for new users. Não há menção ao tutorial do discobot, nem a [details]. Existe Markdown Tutorial - Introduction listado, mas apenas para common mark.
@pfaffman Agora vejo essa opção sob a engrenagem. NĂŁo Ă© que eu nĂŁo clicaria na engrenagem, mas sim que pensei que sabia o que a engrenagem significava - mudar as configurações. (Eu estava errado.) Isso, combinado com a suposição de que provavelmente existem um monte de recursos especĂficos do Discourse como [details], convenci-me de que eles nĂŁo estariam todos listados em algum menu oculto, entĂŁo comecei a procurar um manual.
Eu certamente teria clicado num botão de ajuda se um dos botões fosse obviamente para ajuda (ou seja, um ponto de interrogação). Eu também teria clicado num botão se fosse obviamente para inserir coisas. Eu apenas me convenci subconscientemente de que não poderia ser a engrenagem…
Talvez eu seja old-school, mas realmente quero uma fonte autoritativa para ler onde posso aprender sobre todos os recursos e consultar no futuro. Existe tal coisa, ou aprender através de bots é a nova coisa?
1 curtida
Crie uma nova conta em um site Discourse.
Não há outra forma senão acompanhar os anúncios aqui. Houve um esforço crescente para documentar as coisas aqui na documentação Documentation - Discourse Meta, mas não sei se parece autoritativo.
Obrigado. Então, se eu criar uma nova conta, realmente verei o discobot. No entanto, é muito confuso como interagir com ele para um usuário como eu que entrou antes do discobot começar. Isso talvez esteja um pouco fora do tópico, mas destaca uma necessidade potencial de um botão de ajuda, então manterei a discussão aqui. Sinta-se à vontade para mover ou me direcionar para um tópico melhor, se achar apropriado.
Tendo descoberto recentemente o discobot, tentei usá-lo em nossos sites. Conforme várias discussões e menções, eu esperava que pudesse digitar @discobot start tutorial em algum lugar e aprender…
- Tentei isso no chat do site em um deles. Nada aconteceu. Tentei iniciar um chat pessoal com
@discobot, mas ele não pôde ser encontrado. - Então tentei enviar um “Chat pessoal” para o discobot. Não consegui.
- Em um de nossos sites, consegui adicionar o discobot à minha lista de Chat pessoal, mas pedir a ele para “iniciar tutorial” não fez nada.
- Finalmente, criei uma nova conta neste site e fui recebido pelo bot, o que deixou claro que deveria haver um Tópico com minhas interações com o bot (e que eu deveria marcar este tópico).
Agora vejo que posso pesquisar por discobot em nosso site, ir para a página do usuário dele e entĂŁo enviar uma mensagem, onde, confusamente, preciso inserir um tĂtulo longo e algum conteĂşdo. Finalmente, apĂłs esta mensagem ser criada, posso pedir a ele para “iniciar tutorial”.
Por que isso Ă© tĂŁo difĂcil? Por que o bot nĂŁo responde a solicitações para iniciar o tutorial em chats, chats privados, etc.? E se alguĂ©m que está começando em um site pular as configurações de notificação e nĂŁo notar o discobot? Como eles obtĂŞm ajuda mais tarde?
Não sei qual é a melhor solução, mas um botão de ajuda em algum lugar que me guiasse por isso teria sido muito útil.
1 curtida
Você desativou o Discobot nas suas configurações? Você está executando um discourse muito antigo?
1 curtida