search

microsoft / pxt-adafruit

Microsoft MakeCode editor for Adafruit Circuit Playground Express
https://makecode.adafruit.com
Other
81 stars 77 forks source link

Double download confusion #1085

Open darzu opened 5 years ago

darzu commented 5 years ago

I'm doing the "Loudness Necklace tutorial" on a Chromebook When I click "Download" the file is seen downloading even though a pop up appears with more download instructions. These instructions have a big green button that says "circuitplayground-Loudness-necklace.uf2 \/", which is the obvious next thing to click and when I click it I get a second download.

It seems confusing to me that the "happy path" would have the user download the same program twice.

Futhermore, once the green button is click the dialog does not go away. The user has to click out or click the "x". We should mention that they have to exit when they're done if we're not going to close the dialog automatically.

Also, the instructions say "Click and drag the file you downloaded onto CPLAYBOOT". But someone who is not familiar with Chromebooks (like me) has no idea how to view their folders. We should describe every step in transferring a folder on the Chromebook or give them detailed WebUSB instructions.

Also the computer says "Woah there, next time eject the thumb drive before you remove it". This warning makes it seem like the user did something wrong. We should tell users explicitly not to worry about this otherwise they'll think they messed up somehow.

Bottom line: I really think we should have a link to (or embed) a youtube video showing the whole download process end-to-end. It's quite complicated.

abchatra commented 5 years ago

This is chrome only behavior. I forget the reason why we did this long ago. @pelikhan