Fornisci un link alla documentazione CommonMark dall'editor

Credo che sarebbe utile avere un link al riferimento CommonMark o, in alternativa, a un argomento personalizzato, per aiutare gli utenti nelle operazioni di modifica che non possono essere eseguite tramite i pulsanti della barra degli strumenti. Se è possibile configurare un link a un argomento personalizzato, si potrebbero documentare anche i markup specifici dei plugin, come quello del plugin per i segni di spunta.

Un pulsante con un punto di domanda tutto a destra nella barra degli strumenti sembra un ottimo modo per aggiungere questo link.

7 Mi Piace

Non posso dire se questo finirà nel core a lungo termine, ma sembra che sia un ottimo candidato per iniziare come componente del tema.

11 Mi Piace

Una risposta velocissima: personalizza i testi della chiave education.* sul sito collegandoli all’argomento personalizzato per il tuo sito. :sunglasses:

6 Mi Piace

Questi messaggi vengono visualizzati solo nelle prime volte che componi un nuovo argomento o una nuova risposta, vero?

2 Mi Piace

Sì, ma questo le rende anche un luogo molto più appropriato per queste informazioni :information_source:

4 Mi Piace

Non sono d’accordo. Questo sarebbe un link a un riferimento da consultare quando non ricordi qualche sintassi Markdown che usi raramente. Non è qualcosa che leggi una volta e poi non hai più bisogno di rivedere.

1 Mi Piace

Sembra che tu lavori sotto l’illusione che gli utenti leggeranno qualsiasi cosa tu metta sullo schermo.

Non lo faranno.

Gli approcci migliori consistono nel fornire le informazioni all’utente proprio al momento giusto, quando ne hanno più bisogno — non nel riversare sullo schermo un mucchio di permalink casuali “per sicurezza” che verranno ignorati nel 99,999% dei casi e che aggiungono solo disordine generale per tutti gli utenti.

3 Mi Piace

No, mi dispiace deluderti. :grin: Si tratta semplicemente di un suggerimento egoista per qualcosa che personalmente troverei utile. È ispirato all’editor di GitHub, che include un link alla specifica Markdown di GH, che consulto ogni tanto.

Sono d’accordo, sarebbe la soluzione ideale. Ovviamente, è più facile a dirsi che a farsi. Questo varia enormemente da utente a utente, quindi sono scettico sull’efficacia di un tale approccio senza test approfonditi. Altrimenti si basa solo su supposizioni.

Immagino che “Hai premuto il pulsante :heart?” sia un esempio di questo approccio? Per qualche motivo, Discourse assume che io sia d’accordo con il post a cui sto rispondendo quando il mio messaggio contiene pochissimi caratteri. La prima volta che mi sono imbattuto in questo, quell’assunzione era sbagliata e ha causato solo confusione e frustrazione.

Detto questo, non credo esista una soluzione semplice per educare gli utenti. Probabilmente non esiste alcuna soluzione quando si ha a che fare con utenti di background diversi, quindi per favore non prenderlo come una critica.

2 Mi Piace

Se desideri un promemoria generico su Markdown, dai un’occhiata a commonmark.org!

1 Mi Piace

Un’altra votazione per un piccolo :grey_question: in alto a destra o in basso a destra della casella del compositore.

:ballot_box:

Questo plugin è in circolazione da un po’ di tempo

15 Mi Piace

Le persone che troverebbero utile questo sono in grado di automedicarsi cercando attivamente e trovando le informazioni di cui hanno bisogno. Sono già studenti :star:.

Inoltre… se gli utenti leggessero davvero qualcosa (non lo fanno), sarebbero arrivati al passaggio di formattazione del messaggio privato di benvenuto interattivo di discobot che tutti i nuovi utenti ricevono. Il che è meglio, poiché è dinamico e interattivo, utilizza l’editor effettivo e contiene collegamenti alla guida.

Controlla i tuoi messaggi privati e vedrai lì lo stesso messaggio di benvenuto.

6 Mi Piace

Grazie. Avevo supposto che qualcosa del genere dovesse già esistere, ma non sono riuscito a trovarlo.

Purtroppo, non funziona per me. Bug segnalato qui: Plugin not working with Discourse 2.5.0.beta1 · Issue #12 · cpradio/discourse-plugin-composer-help-button · GitHub

3 Mi Piace

Ho avuto molte persone che mi chiedevano come usare il markdown, quindi sono a favore di questa idea.
Personalmente mi è voluto molto tempo per capire che l’editor utilizzava il markdown e per trovare le istruzioni su come usarlo.

La mia proposta come soluzione è aggiungere una casella blu in alto nell’editor per i nuovi utenti, con un messaggio del tipo:

“Scopri di più su come formattare il testo usando il markdown qui: [link]”

La casella blu può avere una X in alto a destra, così gli utenti che non vogliono più vederla possono chiuderla definitivamente.

3 Mi Piace

Come ha detto Jeff, discobot insegna alcune basi del markdown. Discobot è abilitato sulla tua istanza?

3 Mi Piace

Sì. La serendipità ha colpito e qualcuno mi ha importunato, minacciando di non usare Discourse se non fossi riuscito a spiegare come usarlo.

Alla fine ho copiato e incollato questo articolo e l’ho fissato globalmente nel forum. Ho imparato alcune cose che non conoscevo lungo il cammino.

2 Mi Piace

Un approccio più semplice potrebbe essere stato collegare a

https://commonmark.org/help/

e

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

Entrambi questi link vengono inviati nel messaggio privato di benvenuto per i nuovi utenti che ogni nuovo utente riceve dopo aver creato un account su Discourse.

3 Mi Piace