Discourse Needs help resources and documentation

It would be useful if Discourse came with a help section on how to use it, and explanations on how to set it up. We had to find out how to do everything worked by trial and error. Searching through this forum is time consuming and oriented towards developers.

5 Likes

Did you find the New User tutorial from @discobot helpful?

2 Likes

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

3 Likes

Yes, it was helpful for more advanced features, but our new users needed even more basic site usage information. I had to make my own help section and tutorial so they could figure out how to navigate and post.

3 Likes

Plus our users (mainly teachers) were not familiar with chatbots and the word ā€˜discobotā€™ did not denote ā€˜Helpā€™ to themā€¦

4 Likes

If you wouldnā€™t mind sharing it, weā€™d be interested in seeing what kind of guidance your users needed. Are these people who are generally unfamiliar with forums in general, or are there features specific to Discourse that they were struggling with?

9 Likes

They are not familiar with forums and their mental model is more ā€˜Facebookā€™ oriented. In the usability testing I preformed a good number struggled with a variety of simple tasks. I will ask permission to share our Help resourcesā€¦

7 Likes

Iā€™m in the process of creating similar documentation. I have many older users who are used to listservs and are very tech-challenged post-migration.

2 Likes

When I was using Discourse to teach courses in instructional technology, I set up challenges for students (many of whom were in-service teachers) to do. My assumption was not so much that people needed to be shown how to do things as much as they needed to know what was possible. For example, you donā€™t need to be shown how to customize you profile, you need to know that you have a profile and that you can customize it.

Similarly, just telling people to get the badges lets them know what things are possible, and itā€™s not that hard to go and do it, and you get a badge!

10 Likes

Are these users unfamiliar with the web in general?

1 Like

Hm, interesting. My assumption tended to be the exact opposite: non-technophile people donā€™t care about all the great features and therefore wonā€™t read your instructions (or do the discobot tutorial for that matter) unless it promises to solve the exact problem they have right now).

Maybe it helped that you as the teacher were in the position to actually do stuff, whether they want to or not. Or, perhaps even more importantly, that you met them in class and told them in person: if you do this quest, you wonā€™t regret it.

5 Likes

Or maybe my students were coerced to do what I told them for a grade. I suspect youā€™re right.

5 Likes

Hi Jeff, Our users are comprised entirely of teachers, their skills on the web vary widely. Some users had no problems using Discourse while others found it confusing.

3 Likes

Hi Kris,

Here is a summary of what the users needed help understanding how to do:

  1. How to Reply to a topic (there seemed to be confusion over the inline reply vs the main reply and why their post was not on top. There was also confusion over why a post appears under the inline replay and at the bottom on the feed. Users described posting as ā€˜all over the placeā€™ā€¦)
  2. How to add a new Topic
  3. How to Log Out (it was not a separate menu item)
  4. How to Upload a Picture (upload icon unclear it relates to images)
  5. Why there were both green and blue notifications

It might be helpful if Posts were more delineatedā€¦

I think some very basic user guidance might be helpful. Once they got the hang of it they seemed to like using the application. Some users would not interact with it because it appeared to require too much interaction cost.

10 Likes

Fantastic, this is exactly the kind of feedback I was looking for. @erlend_sh perhaps we could make short videos on these topics, or pay someone to do so at a high level of production quality?

11 Likes

Iā€™d like to add at least one help topic to consider:

  • How to send a private message [PM] vs Reply (which goes to all).

I have cobbled together a not-so attractive document (with screenshots) after a few accidents where the whole member list received what one member thought was a single reply to an individual. A video would be helpful. Or at least a library of standardized, well-described, help topics for new users.

2 Likes

Are your comments mailing list specific, though? Because thatā€™s a very different use case than web browser participation.

1 Like

Iā€™ve had users contact me with the same concerns:

  • How do I send a PM?
  • Will my message be posted in the forum or privately?

A few have replied to a post they received by email thinking they were doing it privately.

2 Likes

I am thinking about both, mailing list and browser. The majority of my members have been migrated from a listserv, so they are used to that functionality. Training them to the web site/browser will take some doing. Still, IMHO, itā€™s not obvious to any new user how to reply to an individual (i.e. MESSAGE) vs replying to the group, no matter the environment. I donā€™t think Discobot covers it, but that would not a be complete solution since not all of my people opt to participate in the bot tutorial.

That leaves me with cooking up a bunch of ā€œHow toā€ postings. Being lazy (busy) Iā€™d love to have a library of this info to copy/cross-post so that I donā€™t have to go to the effort of creating it when - probably - others have written something similar for their Discourse sites.

1 Like

Discourse does not reveal usersā€™ email addresses. Unless mailing list mode reveals them or there is something that Iā€™m missing, there is no way to reply-only-to-sender when replying to a non-PM message via email.

This is counter to how email lists work. As usual, there is a trade-off between increased privacy/security and convenience.

1 Like