O tutorial de usuário avançado ainda existe?

Vejo que há uma medalha chamada Licenciado, descrita como “Concluiu nosso tutorial avançado para usuários.” Tópicos aqui sugerem que o tutorial avançado pode ser iniciado digitando “@discobot start advanced user”, mas na minha instância hospedada, o comando não é reconhecido.

O que estou deixando passar?

Hi! To find out what I can do, say @discobot display help.

O comando para iniciar o tutorial avançado do Discobot é:

@discobot start advanced tutorial

Talvez detalhes sobre como iniciar o tutorial avançado devam ser incluídos na postagem criada quando um usuário digitar @discobot display help?

Obrigado, isso funciona! Sim, parece-me totalmente razoável que “exibir ajuda” mostre isso. Agora que conheço a fórmula, consigo ver como a mensagem de ajuda atual tenta me dizer o que dizer, mas não é nada óbvio.

Não é?

@discobot exibir ajuda

I currently know how to do the following things:

@discobot start tutorial

Starts one of the following interactive tutorials: tutorial, advanced tutorial.

@discobot roll 2d6

:game_die: 3, 6

@discobot quote

:left_speech_bubble: Carry out a random act of kindness, with no expectation of reward, safe in the knowledge that one day someone might do the same for you — Princess Diana

@discobot fortune

:crystal_ball: You may rely on it

Parece correto para mim ↑ ↑ @nedbat

Se eu pudesse sugerir uma edição:

Não ficou claro para mim que a parte “tutorial, advanced tutorial” deveria ser usada como parte do comando.

A mesma coisa! Meus moderadores levantaram as mesmas preocupações.

Quero dizer… talvez? Será que realmente precisamos de múltiplos exemplos? Por exemplo, alguém lê

@discobot roll 2d6

e realmente precisa ver

@discobot roll 12d20
@discobot roll 1d10

para entender que os números podem ser substituídos conforme necessário? :thinking:

Embora seja justo observar que apenas o tutorial espera palavras diferentes, por exemplo:

@discobot start {nome-do-tutorial}

onde {nome-do-tutorial} pode ser tanto tutorial quanto tutorial avançado.

Quando há apenas duas possibilidades, em vez de todo número natural, faz sentido simplesmente escrevê-las por extenso.

Sua ideia também funciona para mim.

O texto não pode ser editado facilmente; ele é programático

`@%{discobot_username} %{reset_trigger} %{default_track}`
 > Inicia um dos seguintes tutoriais interativos: %{tracks}.

Não quero me fixar nisso demais, mas: você poderia editar facilmente esse texto se decidir que ajudar os usuários a encontrar os dois tutoriais atuais é mais importante do que aplicar a programação YAGNI para uma futura possibilidade de um terceiro tutorial.

Ou, mova a construção dos comandos do bot para o código Ruby. O texto não mudará de uma localidade para outra.

Ou, altere para sua sugestão:

`@%{discobot_username} %{reset_trigger} {nome-do-tutorial}`
 > Inicia um tutorial interativo. `{nome-do-tutorial}` pode ser um dos seguintes: `%{tracks}`.

(pull request: Clarify how to start a tutorial by nedbat · Pull Request #7944 · discourse/discourse · GitHub)