Forneça um link para a documentação do CommonMark no editor

Acho que seria útil ter um link para a referência do CommonMark, ou opcionalmente um tópico personalizado, para ajudar as pessoas na edição de conteúdo que não pode ser feito por meio dos botões da barra de ferramentas. Se for possível configurar um link para um tópico personalizado, também seria possível documentar marcações específicas de plugins, como as do plugin de marca de verificação.

Um botão com um ponto de interrogação, posicionado bem à direita na barra de ferramentas, parece ser uma boa maneira de adicionar esse link.

7 curtidas

Não posso dizer se isso acabará no núcleo a longo prazo, mas parece que seria um ótimo candidato para começar como um componente de tema.

11 curtidas

Uma resposta muito rápida: personalize os textos da chave education.* no site, vinculando-os ao tópico personalizado do seu site. :sunglasses:

6 curtidas

Essas mensagens são exibidas apenas nas primeiras vezes em que você cria um novo tópico ou resposta, não é?

2 curtidas

Sim, mas isso também os torna um local muito mais adequado para essas informações :information_source:

4 curtidas

Eu discordo. Isso seria um link para uma referência a ser consultada quando você não se lembrar de alguma sintaxe do Markdown que usa raramente. Não é algo que você lê uma vez e nunca mais precisa revisar.

1 curtida

Parece que você está sob a ilusão de que os usuários lerão qualquer coisa que você colocar na tela.

Eles não vão.

As melhores abordagens envolvem fornecer as informações ao usuário no momento certo, quando mais precisam delas — e não despejar uma série de links permanentes aleatórios na tela “por precaução”, que serão ignorados 99,999% das vezes e apenas aumentam a desordem para todos os usuários.

3 curtidas

Não, desculpe decepcioná-lo. :grin: Isso é simplesmente uma sugestão egoísta para algo que eu pessoalmente acharia útil. Foi inspirado no editor do GitHub, que inclui um link para a especificação de Markdown do GH, que consulto de vez em quando.

Concordo, essa seria a solução ideal. Claro, é mais fácil dizer do que fazer. Isso varia amplamente entre os usuários individuais, então sou cético quanto à eficácia de tal abordagem sem testes extensivos. Caso contrário, é apenas baseado em suposições.

Suponho que o “Você já apertou o botão :heart:” seja um exemplo dessa abordagem? Por alguma razão, o Discourse assume que eu concordo com a postagem à qual estou respondendo quando minha mensagem contém muito poucos caracteres. Quando me deparei com isso pela primeira vez, essa suposição estava errada e causou nada além de confusão e frustração.

Dito isso, não acho que exista uma solução fácil para educar os usuários. Provavelmente não há solução alguma ao lidar com usuários de diferentes origens, então, por favor, não leve isso como uma crítica.

2 curtidas

Se você quer um lembrete genérico de Markdown, confira o commonmark.org!

1 curtida

Outro voto por um pequeno :grey_question: no canto superior/inferior direito da caixa de composição.

:ballot_box:

Este plugin existe há algum tempo

15 curtidas

Os tipos de pessoas que achariam isso útil são capazes de se automedicar buscando e encontrando proativamente as informações de que precisam. Eles já são alunos :star:.

Além disso… se os usuários realmente lessem alguma coisa (eles não leem), teriam chegado à etapa de formatação da mensagem de boas-vindas interativa do discobot que todos os novos usuários recebem. O que é o melhor, pois é dinâmico e interativo, usando o próprio editor, e contém links para a ajuda.

Verifique suas mensagens privadas e você verá essa mesma mensagem de boas-vindas lá também.

6 curtidas

Obrigado. Eu assumi que algo assim já deve existir, mas não consegui encontrá-lo.

Infelizmente, não está funcionando para mim. Bug relatado aqui: Plugin not working with Discourse 2.5.0.beta1 · Issue #12 · cpradio/discourse-plugin-composer-help-button · GitHub

3 curtidas

Muitas pessoas me perguntaram como usar Markdown, então apoiei essa ideia.
Pessoalmente, levei muito tempo para descobrir que o editor usava Markdown e para buscar instruções sobre como usá-lo.

Minha sugestão como solução para isso é adicionar uma caixa azul no topo do editor para novos usuários, dizendo algo como:

“Saiba mais sobre como formatar seu texto usando Markdown aqui: [link]”

A caixa azul pode ter um X no canto superior direito, para que as pessoas que não queiram mais vê-la possam fechá-la permanentemente.

3 curtidas

Como Jeff disse, o discobot ensina alguns fundamentos do Markdown. O discobot está habilitado na sua instância?

3 curtidas

Sim. A sorte favorece e alguém estava me importunando e ameaçando não usar o Discourse se eu não conseguisse explicar como usá-lo.

No final, eu copiei e colei este artigo e o fixei globalmente no fórum. Aprendi algumas coisas que não sabia no processo.

2 curtidas

Uma abordagem mais simples poderia ter sido linkar para

https://commonmark.org/help/

e

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

Ambos os links são enviados na mensagem privada de boas-vindas ao novo usuário que todo novo usuário recebe após criar uma conta no Discourse.

3 curtidas