Tutorial do novo usuário do Discobot: Adicionando etapa para texto pré-formatado

O tutorial para novos usuários do Discobot já cuida da formatação em negrito e itálico, bem como da formatação de citações, por meio das seguintes chaves:

discourse_narrative_bot.new_user_narrative.formatting.instructions
discourse_narrative_bot.new_user_narrative.quoting.instructions

Como em nosso fórum os usuários frequentemente postam arquivos de log ou outras saídas de console, e novos usuários muitas vezes usam a formatação de citação em vez da formatação de texto pré-formatado, ou não usam nenhuma formatação, uma introdução à formatação de texto pré-formatado no tutorial para novos usuários seria muito bem-vinda.

Já examinei os textos de instrução mencionados acima, mas simplesmente adicionar algumas instruções para texto pré-formatado me parece errado, pois o Discobot realmente deveria verificar se o usuário fez a formatação corretamente (o que o Discobot atualmente não faz).

Como posso adicionar instruções para texto pré-formatado ao tutorial para novos usuários do Discobot, de modo que o Discobot realmente verifique se o usuário fez a formatação corretamente?

1 curtida

O que recomendo é ir até /admin/customize/site_texts/, pesquisar por js.composer.reply_placeholder (ou Digite aqui. Use Markdown, BBCode ou HTML para formatar.) e modificar esse texto para algo como:

Digite aqui. Use Markdown, BBCode ou HTML para formatar. Arraste ou cole imagens. Use ``` antes e depois dos blocos de código.

Muito poucas pessoas farão o tutorial de qualquer forma. Há uma pequena chance de que elas notem esse placeholder, mas a maioria ainda apenas colará o conteúdo sem atenção.

1 curtida

Foi exatamente isso que eu pensei inicialmente, mas como escrevi acima: assim não haveria nenhuma verificação se o usuário realmente aplicou a formatação de texto pré-formatado. Ele poderia simplesmente omiti-la completamente e ainda receber a resposta “Ótimo trabalho!”.

Não no nosso fórum: 14 dos 27 novos usuários nos últimos 14 dias passaram completamente pelo tutorial.

2 curtidas

Não é uma má ideia, mas realmente precisar de formatação de código é um pouco raro — temos isso no tutorial avançado? Acredito que é aí que ele deveria estar.

Também gostei bastante da sugestão do @pfaffman de editar o texto de espaço reservado padrão.

No final, talvez você precise fazer o que acabamos de fazer no Stack Overflow e tentar detectar código que foi colado sem formatação, e rejeitar a resposta se você ver muito texto “semelhante a código” na postagem — há uma discussão sobre um plugin para isso aqui no meta.

1 curtida

A formatação de código é uma operação muito básica, que nossos usuários precisam conhecer desde o primeiro dia. Por isso, em nosso fórum, ela não pertence ao tutorial avançado, mas ao tutorial básico.

Com Unformatted Code Detector - #27 by codinghorror pronto para entrar em ação, seria agora possível

?