pxt-arcade icon indicating copy to clipboard operation
pxt-arcade copied to clipboard

Looking for a quick, simple solution to provide extra info without having to divert the coder's attention

Open kiki-lee opened this issue 3 years ago • 13 comments

We know that coders don't like clicking the hint button (and even if they did, we don't have a way to reveal only what the user needs to know when it's most helpful). Eventually, I'd like a "smart tab" that lets users get more info in a new doc tab so they can dig as deeply into a concept as they'd like. That will be crucial for feeding curiosity, but until then, I need a lightweight solution for differentiation so that more advanced users can move through tutorials without feeling patronized while newer users can have additional levels of detail tailored to their own preferences.

Design specs:

  • Allow users to choose whether or not they see extra info (and when)
  • Don't derail a user's "flow" (don't take them away from the stream of thought they're in)
  • Seems like an "expected" option, not a "cheat", "hint", or admission of failure

Use cases:

  • "Clues" for Sherlock
  • "Here's a way to get around something that might be tricky" inside instructions
  • "Here's a video/animation/bottom-out and hand-holdy bit of information that pertains to this idea"

kiki-lee avatar Jan 31 '22 21:01 kiki-lee

@kiki-lee can you please provide us with two example screens of the content you'd like to share so we can have something to work with? @unthinkmedia alex will add this to his list of projects. When are you hoping this will be complete by? Thank you!

BeckHaru avatar Feb 01 '22 20:02 BeckHaru

Sure, here's an example of the context. Take a look at the PDF for more detail. image

Until maps are updated, we'd just have current hints show up in a container at the end of the appropriate step.

toggleHintsExample.pdf

@BeckHaru @unthinkmedia

kiki-lee avatar Feb 04 '22 00:02 kiki-lee

FYI, this is #2 on my Top 10 List.

kiki-lee avatar Feb 08 '22 01:02 kiki-lee

Connection with #4617 ?

kiki-lee avatar Feb 08 '22 22:02 kiki-lee

https://github.com/microsoft/pxt-arcade/issues/4617 - related issue.

BeckHaru avatar Feb 08 '22 22:02 BeckHaru

I think this and the #4617 are separate issues, but let's discuss if anyone disagrees. We may just want to check and see if the discoverability work would impact how we go about this, since it does have a direct impact on that area.

unthinkmedia avatar Feb 15 '22 14:02 unthinkmedia

@kiki-lee would we consider this issue closed? Wasn't sure if there was more to add this.

unthinkmedia avatar Apr 21 '22 14:04 unthinkmedia

Not closed, but ready to be passed to engineering.

kiki-lee avatar Apr 21 '22 16:04 kiki-lee

The spec for this feature is on page 6/7 of this doc: https://microsoft-my.sharepoint.com/:w:/p/jefo/EdiVdHziX2tNlcJqKNwSk2cBmU2XIEgIq5z_c0JZWNOmZQ?e=OZj10M

kiki-lee avatar May 26 '22 18:05 kiki-lee

Not having any luck adding @momuno or @adrianwyatt
Can you try, @abchatra ?

kiki-lee avatar May 26 '22 18:05 kiki-lee

Added to PXT guest. Should be able to do this now.

abchatra avatar May 27 '22 16:05 abchatra

I still can't assign to either @adrianwyatt or @momuno

kiki-lee avatar May 27 '22 16:05 kiki-lee

Not sure why you are not able to assign. I can though.

abchatra avatar May 27 '22 16:05 abchatra

This is implemented.

abchatra avatar Sep 28 '22 00:09 abchatra