Self-help feature

[flbulgarelli]

Or maybe Meta-feedback?

Introduction

Many times, events occur that - although expected - are difficult to understand to the user the first time they happen. For example:

UI-specific Events

• The first time a user enters an exercise, she may not understand she has to carefully read the description
• The first time a user enters a problem, she may not understand she has to submit code on the editor
• The first time a user enters an exercise with a hint, she may not recognize it and read it
• The first time the community link appears, she may not understand she should ask on doubt
• The first time a playground is rendered, she may not understand how to use it.

General Programming Events

• The first time a user encounters an errored result, she needs to understand that it normally means a syntax error and what a syntax error means
• The first time a user encounters a failed result, she needs to understand that she needs to read the description, fix the code and try again

Proposal

We should add flags to the user, so that specific help messages are displayed in a popup the first time they occur.

Such popups should have an "ok, got it" and "please explain it me later" actions, in order to control if we should display it again. Perhaps we could have an admin method and/or a profile UI option to restart them.

Such popups should not be stackable and only one per event should be displayed, in order to not distract user. For example, if the first exercise she enters is a playground and has a hint, only the most generic of the help messages should be displayed - in this case, explain what a playground is - and display the remaining popup in a future exercise.

[flbulgarelli]

@fedescarpa @lauramangifesta @asanzo

[asanzo]

Great idea!! 😁

Gobstones web has this (not nearly as complete, but yet simple, beautiful and effective)

On the other hand, code.org gets a bit noisy when they abuse of this feature. Just lets not do it very invasive, or very repeatedly.

I tend to trust children's fearlessness to touch and try and break. However, it is true that for some, the shy ones, they can be benefitted from this, as well as the teachers :) 👍👍👍

[lauramangifesta]

We should take this into account when we realize the audiovisual material. An important number of users is not going to read the pop-ups. The videos could work as a good complement, showing how the editor works, the importance of reading the explanation, how to use the playground, etc.

[aguspina]

Maybe we should make a video with a sample tutorial of the app.

El jue., 22 feb. 2018 14:49, lauramangifesta notifications@github.com escribió:

We should take this into account when we realize the audiovisual material. An important number of users is not going to read the pop-ups. The videos could work as a good complement, showing how the editor works, the importance of reading the explanation, how to use the playground, etc.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/mumuki/mumuki-laboratory/issues/947#issuecomment-367763513, or mute the thread https://github.com/notifications/unsubscribe-auth/AD6mDMu7gZw9JTav0bBB6eSTZI2xEzA1ks5tXaitgaJpZM4SPU3j .

[aguspina]

Don't mind my previous comment. Update a videtutorial everytime we change the layout is not simple.

El jue., 22 feb. 2018 16:59, Agustin Pina aguspina87@gmail.com escribió:

Maybe we should make a video with a sample tutorial of the app.

El jue., 22 feb. 2018 14:49, lauramangifesta notifications@github.com escribió:

We should take this into account when we realize the audiovisual material. An important number of users is not going to read the pop-ups. The videos could work as a good complement, showing how the editor works, the importance of reading the explanation, how to use the playground, etc.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/mumuki/mumuki-laboratory/issues/947#issuecomment-367763513, or mute the thread https://github.com/notifications/unsubscribe-auth/AD6mDMu7gZw9JTav0bBB6eSTZI2xEzA1ks5tXaitgaJpZM4SPU3j .