Vedo che esiste un badge chiamato Licensed, descritto come “Completato il nostro tutorial per utenti avanzati”. Alcuni argomenti qui suggeriscono che il tutorial avanzato possa essere avviato digitando “@discobot start advanced user”, ma sulla mia istanza ospitata non viene riconosciuto.
Cosa mi sta sfuggendo?
Hi! To find out what I can do, say @discobot display help.
Il comando per avviare il tutorial avanzato di discobot è:
@discobot start advanced tutorial
Forse sarebbe utile includere dettagli sull’avvio del tutorial avanzato nel post che viene creato quando un utente invia @discobot display help?
Grazie, funziona! Sì, mi sembra del tutto ragionevole che “display help” mostri questo. Ora che conosco l’incantesimo, vedo come il messaggio di aiuto attuale cerchi di dirmi cosa dire, ma non è affatto ovvio.
Non è vero?
@discobot visualizza aiuto
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
3, 6
@discobot quote
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
You may rely on it
A me sembra corretto ↑ ↑ @nedbat
Se posso suggerire una modifica:
Non mi era chiaro che la parte “tutorial, advanced tutorial” dovesse essere utilizzata come parte del comando.
Anche per me! I miei moderatori hanno sollevato le stesse preoccupazioni.
Voglio dire… forse? Dobbiamo davvero avere più esempi, ad esempio qualcuno legge
@discobot roll 2d6
e ha davvero bisogno di vedere
@discobot roll 12d20
@discobot roll 1d10
per capire che i numeri possono essere sostituiti a seconda delle necessità? 
Anche se è giusto notare che solo il tutorial si aspetta parole diverse, ad esempio
@discobot start {nome-del-tutorial}
dove {nome-del-tutorial} può essere sia tutorial che advanced tutorial.
Quando ci sono solo due possibilità, invece di ogni numero naturale, ha senso semplicemente esplicitarle.
Anche la tua idea va bene per me.
Il testo non può essere modificato facilmente; è generato in modo programmatico
`@%{discobot_username} %{reset_trigger} %{default_track}`
> Avvia uno dei seguenti tutorial interattivi: %{tracks}.
Non intendo insistere troppo su questo, ma: potresti modificare facilmente questo testo se decidi che aiutare gli utenti a trovare i due tutorial attuali è più importante della programmazione YAGNI per una futura possibilità di un terzo tutorial.
In alternativa, sposta la costruzione dei comandi del bot nel codice Ruby. Il testo non cambierà da una localizzazione all’altra.
Oppure, modifica con il tuo suggerimento:
`@%{discobot_username} %{reset_trigger} {nome-del-tutorial}`
> Avvia un tutorial interattivo. `{nome-del-tutorial}` può essere uno di: `%{tracks}`.
(pull request: Clarify how to start a tutorial by nedbat · Pull Request #7944 · discourse/discourse · GitHub)