Proporcionar un enlace a la documentación de CommonMark desde el editor

Creo que sería útil tener un enlace a la referencia de CommonMark, o opcionalmente a un tema personalizado, para ayudar a las personas con la edición que no se puede realizar mediante los botones de la barra de herramientas. Si se puede configurar un enlace a un tema personalizado, también se podría documentar el marcado específico de plugins, como el del plugin de marca de verificación.

Un botón con un signo de interrogación al extremo derecho de la barra de herramientas parece una buena manera de agregar este enlace.

7 Me gusta

No puedo decir si esto terminaría en el núcleo a largo plazo, pero parece que sería un excelente candidato para un componente de tema para empezar.

11 Me gusta

Una respuesta muy rápida: personaliza los textos de la clave education.* en el sitio para que enlacen al tema personalizado de tu sitio. :sunglasses:

6 Me gusta

Estos mensajes solo se muestran las primeras veces que redactas un nuevo tema o respuesta, ¿verdad?

2 Me gusta

Sí, pero eso también las convierte en un lugar mucho más apropiado para esta información :information_source:

4 Me gusta

No estoy de acuerdo. Esto sería un enlace a una referencia para consultar cuando no recuerdes alguna sintaxis de Markdown que usas poco. No es algo que se lea una vez y luego nunca necesites volver a revisar.

1 me gusta

Parece que trabajas bajo la ilusión de que los usuarios leerán cualquier cosa que pongas en la pantalla.

No lo harán.

Las mejores estrategias consisten en proporcionar la información al usuario justo a tiempo, cuando más la necesita, en lugar de arrojar un montón de enlaces permanentes aleatorios en la pantalla “por si acaso”, que serán ignorados el 99,999 % de las veces y que solo añaden desorden para todos los usuarios.

3 Me gusta

No, lo siento si te decepciono. :grin: Esto es simplemente una sugerencia egoísta para algo que personalmente encontraría útil. Está inspirado en el editor de GitHub, que incluye un enlace a la especificación de Markdown de GH, a la que consulto de vez en cuando.

Estoy de acuerdo, esa sería la solución ideal. Por supuesto, es más fácil decirlo que hacerlo. Esto varía enormemente entre los usuarios individuales, así que soy escéptico sobre la eficacia de un enfoque así sin pruebas exhaustivas. De lo contrario, se basa simplemente en suposiciones.

Supongo que lo de «¿Has pulsado el botón :heart?» es un ejemplo de este enfoque? Por alguna razón, Discourse asume que estoy de acuerdo con la publicación a la que respondo cuando mi mensaje contiene muy pocos caracteres. Cuando me encontré con esto por primera vez, esa suposición era incorrecta y solo causó confusión y frustración.

Dicho esto, no creo que exista una solución sencilla para educar a los usuarios. Probablemente no haya ninguna solución en absoluto cuando se trata de usuarios con diferentes antecedentes, así que por favor no lo tomes como una crítica.

2 Me gusta

Si quieres un recordatorio genérico de Markdown, ¡visita commonmark.org!

1 me gusta

Otro voto por un pequeño :grey_question: en la esquina superior/inferior derecha del cuadro del compositor.

:ballot_box:

Este plugin ha estado aquí por un tiempo

15 Me gusta

Los tipos de personas que encontrarían esto útil son capaces de automedicarse buscando y encontrando proactivamente la información que necesitan. Ya son estudiantes :star:.

Además… si los usuarios realmente leyeran algo (no lo hacen), habrían llegado al paso de formato del mensaje privado de bienvenida del discobot interactivo que reciben todos los usuarios nuevos. Lo cual es lo mejor, ya que es dinámico e interactivo, utiliza el editor real y contiene enlaces a la ayuda.

Revisa tus mensajes privados y verás ese mismo mensaje de bienvenida allí también.

6 Me gusta

Gracias. Asumí que algo así ya debía existir, pero no logré encontrarlo.

Por desgracia, no me funciona. El error se ha reportado aquí: Plugin not working with Discourse 2.5.0.beta1 · Issue #12 · cpradio/discourse-plugin-composer-help-button · GitHub

3 Me gusta

Muchas personas me han preguntado cómo usar Markdown, así que me parece una gran idea.
Personalmente, me llevó mucho tiempo descubrir que el editor utiliza Markdown y buscar instrucciones sobre cómo usarlo.

Mi propuesta como solución para esto es agregar un cuadro azul en la parte superior del editor para los nuevos usuarios, con un mensaje como:

“Aprende más sobre cómo formatear tu texto usando Markdown aquí: [enlace]”

El cuadro azul puede tener una X en la esquina superior derecha, para que quienes ya no quieran verlo puedan cerrarlo de forma permanente.

3 Me gusta

Como dijo Jeff, discobot enseña algunos conceptos básicos de Markdown. ¿Está habilitado discobot en tu instancia?

3 Me gusta

Sí. La suerte hizo su aparición y alguien me estaba molestando, amenazando con dejar de usar Discourse si no podía explicar cómo utilizarlo.

Al final, copié y pegué este artículo y lo fijé globalmente en el foro. Aprendí algunas cosas que no sabía en el proceso.

2 Me gusta

Un enfoque más sencillo podría haber sido enlazar a

https://commonmark.org/help/

y

https://blog.discourse.org/2016/12/discourse-new-user-tips-and-tricks/

Ambos enlaces se envían en el mensaje privado de bienvenida al nuevo usuario que recibe cada nuevo usuario tras crear una cuenta en Discourse.

3 Me gusta