# Does the advanced user tutorial still exist?

**URL:** https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661
**Category:** Support
**Created:** [July 22, 2019, 5:48pm UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661 "2019-07-22T17:48:49Z")
**Posts on this page:** 16
**Page:** 1

<div class="post-metadata">

### Author: ![nedbat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nedbat/32/150103_2.png) [@nedbat](https://meta.discourse.org/u/nedbat)
#### Post date: [July 22, 2019, 5:48pm UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/1 "2019-07-22T17:48:49Z")

</div>

I see there’s a badge called Licensed, described as “Completed our advanced user tutorial.” [Topics here](https://meta.discourse.org/t/rename-discobots-start-new-user-command/116703/6) suggest the advanced tutorial can be started by typing “@discobot start advanced user”, but on my hosted instance, it’s not understood.

What am I missing?

---

<div class="post-metadata">

### Author: ![discobot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discobot/32/68978_2.png) [@discobot](https://meta.discourse.org/u/discobot)
#### Post date: [July 22, 2019, 5:48pm UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/2 "2019-07-22T17:48:51Z")

</div>

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

---

<div class="post-metadata">

### Author: ![simon](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/simon/32/339122_2.png) [@simon](https://meta.discourse.org/u/simon)
#### Post date: [July 22, 2019, 6:41pm UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/3 "2019-07-22T18:41:32Z")

</div>

> [@nedbat](#):
>
> [Topics here](https://meta.discourse.org/t/rename-discobots-start-new-user-command/116703/6) suggest the advanced tutorial can be started by typing “@discobot start advanced user”, but on my hosted instance, it’s not understood.

The command to start the advanced discobot tutorial is:

```plaintext
@discobot start advanced tutorial

```

Maybe details about starting the advanced tutorial should be included in the post that is created when a user posts `@discobot display help` ?

---

<div class="post-metadata">

### Author: ![nedbat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nedbat/32/150103_2.png) [@nedbat](https://meta.discourse.org/u/nedbat)
#### Post date: [July 22, 2019, 7:47pm UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/4 "2019-07-22T19:47:22Z")

</div>

Thanks, that works! Yes, it seems entirely reasonable to me for “display help” to show this. Now that I know the incantation, I can see how the current help message is trying to tell me what to say, but it is far from obvious.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [July 23, 2019, 12:34am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/5 "2019-07-23T00:34:33Z")

</div>

Doesn’t it?

@discobot display help

---

<div class="post-metadata">

### Author: ![discobot](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discobot/32/68978_2.png) [@discobot](https://meta.discourse.org/u/discobot)
#### Post date: [July 23, 2019, 12:34am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/6 "2019-07-23T00:34:37Z")

</div>

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

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [July 23, 2019, 12:35am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/7 "2019-07-23T00:35:00Z")

</div>

Looks correct to me ↑ ↑ @nedbat

---

<div class="post-metadata">

### Author: ![nedbat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nedbat/32/150103_2.png) [@nedbat](https://meta.discourse.org/u/nedbat)
#### Post date: [July 23, 2019, 1:47am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/8 "2019-07-23T01:47:11Z")

</div>

If I could suggest an edit:

> [@discobot](#):
>
> I currently know how to do the following things:
> 
> `@discobot start tutorial`  
> `@discobot start advanced tutorial`
> 
> > Starts one of the interactive tutorials.

It was not clear to me that the “tutorial, advanced tutorial” part was meant to be used as part of the command.

---

<div class="post-metadata">

### Author: ![justin.noom](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/justin.noom/32/147907_2.png) [@justin.noom](https://meta.discourse.org/u/justin.noom)
#### Post date: [July 23, 2019, 1:55am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/9 "2019-07-23T01:55:45Z")

</div>

> [@nedbat](#):
>
> It was not clear to me that the “tutorial, advanced tutorial” part was meant to be used as part of the command.

Ditto! My moderators have raised the same concerns.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [July 23, 2019, 2:23am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/10 "2019-07-23T02:23:12Z")

</div>

I mean .. _maybe?_ Do we really need multiple examples, e.g. does someone read

`@discobot roll 2d6`

and really _need_ to see

`@discobot roll 12d20`  
`@discobot roll 1d10`

to understand that the numbers can be substituted as needed? 🤔

Although it is fair to note that only the tutorial expects different words, e.g.

`@discobot start {name-of-tutorial}`

where `{name-of-tutorial}` can be either `tutorial` or `advanced tutorial`.

---

<div class="post-metadata">

### Author: ![riking](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/riking/32/170938_2.png) [@riking](https://meta.discourse.org/u/riking)
#### Post date: [July 23, 2019, 4:49am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/11 "2019-07-23T04:49:49Z")

</div>

When there’s only two possibilities, instead of _every natural number_, it makes sense to just spell it out.

---

<div class="post-metadata">

### Author: ![nedbat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nedbat/32/150103_2.png) [@nedbat](https://meta.discourse.org/u/nedbat)
#### Post date: [July 23, 2019, 10:09am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/12 "2019-07-23T10:09:10Z")

</div>

Your idea works for me too.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [July 25, 2019, 7:01am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/13 "2019-07-25T07:01:24Z")

</div>

The copy can’t be easily edited; it’s programmatic

```
`@%{discobot_username} %{reset_trigger} %{default_track}`
 > Starts one of the following interactive tutorials: %{tracks}.

```

---

<div class="post-metadata">

### Author: ![nedbat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nedbat/32/150103_2.png) [@nedbat](https://meta.discourse.org/u/nedbat)
#### Post date: [July 25, 2019, 10:14am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/14 "2019-07-25T10:14:10Z")

</div>

I don’t mean to fixate on this too much, but: you could easily edit this text if you decide that helping users find the two current tutorials is more important than YAGNI coding for a future possibility of a third tutorial.

Or, move the construction of the bot commands into the Ruby code. The text won’t change from locale to locale.

---

<div class="post-metadata">

### Author: ![nedbat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nedbat/32/150103_2.png) [@nedbat](https://meta.discourse.org/u/nedbat)
#### Post date: [July 25, 2019, 3:01pm UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/15 "2019-07-25T15:01:54Z")

</div>

Or, change it to your suggestion:

```plaintext
`@%{discobot_username} %{reset_trigger} {name-of-tutorial}`
 > Starts an interactive tutorial. `{name-of-tutorial}` can be one of: `%{tracks}`.

```

(pull request: [Clarify how to start a tutorial by nedbat · Pull Request #7944 · discourse/discourse · GitHub](https://github.com/discourse/discourse/pull/7944))

---

<div class="post-metadata">

### Author: ![system](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/system/32/443519_2.png) [@system](https://meta.discourse.org/u/system)
#### Post date: [January 23, 2023, 11:19am UTC](https://meta.discourse.org/t/does-the-advanced-user-tutorial-still-exist/123661/16 "2023-01-23T11:19:38Z")

</div>


