A help button could be useful either way
15 Me gusta
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 Me gusta
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 Me gusta
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 Me gusta
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 Me gusta
None of that is new; I worked with Ben to add that in 2010/2011. See proof here…
4 Me gusta
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 Me gusta
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 Me gusta
Publicando una solicitud más reciente para algo similar: Hard to find the Markdown help button
3 Me gusta
Mi opinión sobre esto:
Las personas inexpertas realmente no saben cómo usar las funciones de markdown.
Una ayuda de markdown facilitaría a los usuarios novatos el aprendizaje de markdown. Otros usuarios han publicado cosas para obtener ayuda con markdown. Creo que sería útil tener esta función, ya que ayudaría con la facilidad de acceso.
Como alternativa, también podemos agregar más botones de markdown en la parte superior para los novatos. Sin embargo, el problema con eso es que hace que el diseño sea más confuso.
2 Me gusta
Creo que sería una gran idea añadir esta sección (barra de herramientas) a New User Tips también, como mencionó Jeff arriba. 
Con una pequeña descripción y un enlace configurable en su interior. Puede ir a un tema propio sobre formato como Understanding Discourse for new users
O puede ir directamente a la Ayuda de Markdown Markdown Reference
4 Me gusta
Los usuarios ven:
Escribe aquí. Usa Markdown, BBCode o HTML para dar formato.
OK, usan Markdown, BBCode o HTML, pero descubren que algunas cosas no funcionan,
y hay otras cosas que otros usuarios usan que funcionan pero que ellos no conocían.
Así que hay diferentes versiones de Markdown, BBCode o HTML.
Así que en Ayuda, Discourse debería decir qué versiones.
O en lugar de eso, simplemente tener la lista completa de elementos de marcado que
Discourse usa.
O al menos tener un enlace a dónde está en el código fuente.
Pero los usuarios normales no podrían entender ese código fuente,
Así que todavía sería mejor tener una lista completa, o llamarlo hoja de trucos,
de los operadores de marcado implementados por Discourse.
2 Me gusta
¿Dónde está documentada la sintaxis [details=summary][/details]?
- No se menciona en ninguna de las páginas referenciadas anteriormente, ya que es una característica personalizada de Discourse.
- Una búsqueda de “details” en meta muestra que existe y que podría describirse como “ocultar”, pero no da ninguna pista sobre cómo funciona la sintaxis del resumen.
- Una búsqueda en la web muestra el repositorio discourse-details, pero ahora no contiene información excepto “Plugin obsoleto, ahora es parte de Discourse por defecto”.
- Finalmente lo encontré en Details in topic styling changes - Feedback. No es donde esperaría enviar a los usuarios para que aprendan la sintaxis.
Realmente me hubiera gustado un botón de ayuda que enlazara a algún tipo de documentación oficial…
Es parte del tutorial de discobot
1 me gusta
Si haces clic en el engranaje, te ofrecerá insertarlo por ti
Así que la gente que no haga clic en el engranaje probablemente tampoco hará clic en un icono de ayuda. 
1 me gusta
¿Hay un tutorial de discobot? He estado usando y promoviendo Discourse durante muchos años y nunca me he encontrado con esto, ni con la idea de que sea el lugar al que se debe ir para aprender a usar Discourse. Incluso ahora, no tengo idea (mirando nuestra instancia de Discourse) de cómo podría ejecutar esto.
Pensé que debía estarme perdiendo algo, o tal vez el discobot se introdujo después de que comencé a usar Discourse, así que fui a Understanding Discourse for new users. No se menciona ni el tutorial de discobot ni [details]. Hay Markdown Tutorial - Introduction listado, pero solo para common mark.
@pfaffman Ahora veo esa opción debajo del engranaje. No es que no hiciera clic en el engranaje, sino que pensé que sabía lo que significaba el engranaje: cambiar la configuración. (Estaba equivocado). Eso, combinado con la suposición de que probablemente hay un montón de características específicas de Discourse como [details], me convencí de que no todas estarían listadas en algún menú oculto, así que comencé a buscar un manual.
Ciertamente habría hecho clic en un botón de ayuda si uno de los botones fuera obviamente para ayuda (es decir, un signo de interrogación). También habría hecho clic en un botón si fuera obviamente para insertar cosas. Simplemente me había convencido subconscientemente de que no podía ser el engranaje…
Quizás soy de la vieja escuela, pero realmente quiero una fuente autorizada para leer donde pueda aprender sobre todas las características y consultarlas en el futuro. ¿Existe tal cosa, o aprender a través de bots es lo nuevo?
1 me gusta
Crea una nueva cuenta en un sitio de Discourse.
No hay otra que mantenerse al día con los anuncios aquí. Se ha incrementado el esfuerzo para documentar cosas aquí en la documentación Documentation - Discourse Meta, pero no sé si se siente autorizada.
Gracias. Entonces, si creo una nueva cuenta, veo el discobot. Sin embargo, es muy confuso cómo interactuar con él para un usuario como yo que se unió antes de que comenzara el discobot. Esto es quizás un poco fuera de tema, pero resalta una posible necesidad de un botón de ayuda, así que mantendré la discusión aquí. Siéntete libre de moverla o dirigirme a un tema mejor si crees que es apropiado.
Habiendo descubierto recientemente el discobot, intenté usarlo en nuestros sitios. Según varias discusiones y menciones, esperaba poder escribir @discobot start tutorial en algún lugar y aprender…
- Intenté esto en el chat del sitio en un sitio. No pasó nada. Intenté iniciar un chat personal con
@discobot, pero no se pudo encontrar. - Luego intenté enviar un “chat personal” al discobot. No pude.
- En uno de nuestros sitios, pude agregar discobot a mi lista de chats personales, pero pedirle que “iniciara el tutorial” no hizo nada.
- Finalmente, creé una nueva cuenta en este sitio y fui recibido por el bot, lo que dejó claro que debería haber un Tema con mis interacciones con el bot (y que debería marcar este tema).
Ahora veo que puedo buscar discobot en nuestro sitio, ir a su página de usuario y luego enviarle un mensaje, donde confusamente necesito ingresar un título largo y algo de contenido. Finalmente, después de que se crea este mensaje, puedo pedirle que “inicie el tutorial”.
¿Por qué es tan difícil? ¿Por qué el bot no responde a las solicitudes para iniciar el tutorial en chats, chats privados, etc.? ¿Qué pasa si alguien que comienza en un sitio se salta la configuración de notificación y no nota el discobot? ¿Cómo obtienen ayuda más tarde?
No sé cuál es la mejor solución, pero un botón de ayuda en algún lugar que me guiara a través de esto habría sido muy útil.
1 me gusta
¿Desactivaste Discobot en tu configuración? ¿Estás ejecutando una versión muy antigua de Discourse?
1 me gusta