hchiam / code-tutor

Let's help people who can't use their hands to learn to code by talking to the Google Assistant (voice assistant).
https://assistant.google.com/services/a/uid/000000668d1fb538
MIT License
4 stars 2 forks source link

How might we improve user experience regardless of previous exposure to programming? #27

Closed hchiam closed 6 years ago

hchiam commented 6 years ago

(Based on some of the feedback I've gotten so far.)

Idea 1:

Give a code example to set expectations?

Right when a user "opens" the app, set expectations by showing an example of code? (So change the intro?)

For Example:

Hi! This is Code Tutor.
Here's an example of what you can make:

let greeting = "hi there ";
let name = "someone";
let message = greeting + name;
if (name == "someone")
  say("What's your name?");
for (let i=0; i<3; i++)
  say(message);

Voiceover:

Hi! This is Code Tutor. Here's an example of what you can make: Let greeting equal hi there. Let name equal someone. Let message equal greeting plus name. If name equals someone, then say what's your name. And then, while counting from 0, and stopping before 3, say message.

hchiam commented 6 years ago

Idea 2:

Suggest the sandbox feature earlier in the conversation flows?

hchiam commented 6 years ago

Idea 1.5:

I've already been working on example code shown in Idea 1. I recently changed the welcome message so the user can ask for the example (instead of overwhelming them):

You can talk to me to create simple code. 
I can teach you about variables, arrays, strings, and loops. 
What would you like to create first? 
For example, you can say "a variable". 
Or I can give you an example.
hchiam commented 6 years ago

And "sandbox feature" for more advanced users. (Added more tweaks: https://github.com/hchiam/code-tutor/commit/a4a0d2c87ec3aa2bab799656df606c37754142eb)

hchiam commented 6 years ago

Need to test. Reopen if need to revisit.