Я вижу, что есть значок под названием «Licensed», который описывается как «Пройден наш продвинутый учебник для пользователей». Темы здесь предполагают, что продвинутый учебник можно начать, введя «@discobot start advanced user», но на моём размещённом экземпляре эта команда не распознаётся.
Что я упускаю?
Hi! To find out what I can do, say @discobot display help.
Команда для запуска продвинутого учебника Discobot:
@discobot start advanced tutorial
Возможно, стоит добавить информацию о запуске продвинутого учебника в сообщение, которое создается, когда пользователь вводит @discobot display help?
Спасибо, всё работает! Да, мне кажется вполне разумным, чтобы «показать справку» выводила это. Теперь, когда я знаю нужную команду, я понимаю, что текущее сообщение о помощи пытается подсказать, что именно нужно сказать, но это далеко не очевидно.
Разве нет?
@discobot показать справку
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
Мне кажется, всё верно ↑ ↑ @nedbat
Если можно предложить правку:
Мне не было понятно, что часть «tutorial, advanced tutorial» должна использоваться как часть команды.
То же самое! Мои модераторы выразили те же опасения.
Я имею в виду… может быть? Действительно ли нам нужно несколько примеров? Например, если кто-то читает
@discobot roll 2d6
и ему действительно нужно увидеть
@discobot roll 12d20
@discobot roll 1d10
чтобы понять, что числа можно подставлять по мере необходимости? 
Хотя справедливо отметить, что разные формулировки ожидаются только в руководстве, например:
@discobot start {name-of-tutorial}
где {name-of-tutorial} может быть либо tutorial, либо advanced tutorial.
Когда есть только два варианта, а не все натуральные числа, логичнее просто перечислить их.
Мне тоже подходит ваша идея.
Текст нельзя легко редактировать; он генерируется программно
`@%{discobot_username} %{reset_trigger} %{default_track}`
> Запускает один из следующих интерактивных руководств: %{tracks}.
Я не хочу зацикливаться на этом слишком сильно, но: вы легко можете отредактировать этот текст, если решите, что помощь пользователям в поиске двух текущих руководств важнее, чем следование принципу YAGNI ради будущей возможности добавления третьего руководства.
Или перенесите создание команд бота в код на Ruby. Текст не будет меняться в зависимости от локализации.
Или измените на ваше предложение:
`@%{discobot_username} %{reset_trigger} {название-урока}`
> Запускает интерактивный урок. `{название-урока}` может быть одним из: `%{tracks}`.
(запрос на слияние: Clarify how to start a tutorial by nedbat · Pull Request #7944 · discourse/discourse · GitHub)