upide icon indicating copy to clipboard operation
upide copied to clipboard

Getting started was hard

Open maarten-pennings opened this issue 2 years ago • 6 comments

When I first opened the app (using LEGO), I discarded it because I missed the key features.

That was due to three reasons

  • I missed the "material design" aspect (do not see that often in Windows), so I simply didn't realize that "enter interactive mode" icon was there and that I could click it.
  • The REPL was nice, but there is no plain .py file to open and run, and REPL is not enough so I quit the app.
  • I missed the fact that I could right click on a directory and select new or example

May I suggest

  • that the right hand side start screen gives these hints:
    • double click any .py file to open and run it
    • right click any directory to create a .py file
    • click the "enter interactive mode" icon for REPL
  • maybe add a material design [+] button on the right hand side start screen to select and example.
  • maybe add a button row (like arduino) with few buttons [new] [repl] [download] [run]

For example

image

maarten-pennings avatar Mar 23 '22 20:03 maarten-pennings

Very good point. Yes, I could do that. But I could also do this:

In that default window I could just add a "Need help? Click here for more information" button. And if you click that a special editor tab would open that would actually not be an editor but a getting started help page.

How would you like that?

The [+] button seems obvious, but it has one major disadvantage: It would not tell µPIDE where the file is to be located on the device. I don't see an intuitive way to let the user specify that location at a later stage.

The same goes for the button bar. In Arduino there is one sketch (which may consist of several files but it's still a single sketch). So whatever you do in the button bar relates to this entire sketch. In µPIDE you deal with individual files and it would not be obvious what a button click relates to. Where is a file being created if you click [+]? Which file is being saved if you click [v] ? All open ones?

harbaum avatar Mar 24 '22 07:03 harbaum

Don't mind the help page - good idea - but users who want to get going don't read - they want instant clearness.

A plain [+] has a disadvantage. What about this dialog when the [+] is pressed?

image


Your point about which file to run or which directory to use for new is only partially valid.

The left hand side tree typically has an active selection, and also the right hand-side file tabs has an active file.

maarten-pennings avatar Mar 25 '22 21:03 maarten-pennings

Hope I don't offend you or make you unhappy with all my issues - I love the tool and its clean design!

maarten-pennings avatar Mar 25 '22 21:03 maarten-pennings

Did you see the new help button?

harbaum avatar Apr 15 '22 12:04 harbaum

Regarding your suggested "New file" dialog. The "browse" function behind "Enter directory name" would have to duplicate much of the file tree functionality. This is a) a lot of work for something that already exists and b) I am generally not a fan of duplicate functionality.

Why would one want to have multiple ways to achieve the same thing? If there's a need for a "better" way to do something then we need to ask if the old way of doing it should be removed entirely. Should it? Is the "new" context menu to difficult to use? Would your "new file" dialog incl. the browse widget be easier to use?

harbaum avatar Apr 15 '22 12:04 harbaum

I understand the doubleness argument and don't like duplication either. It happens a lot by the way because different users have different styles of working, different expertise level and different knowledge of the tool. Think of how you can do feature in eg MSWord: app menu, button bar, hotkey, right click entry).

The crux of this ticket is about features not being clearly visible, and suggesting making them visible to help (novice) user. The "new" feature being one of the most important ones. I suggested adding it to the "banner" page as a floating button and to a button bar. You explained that it was hard because "new" had sub-features (target directory, example), so I showed a possible dialog.

I personally like the button bar - I think it is a very clear indication of the core features for (novice) users. My dialog "repairs" the problem of the sub-features.

I would not eliminate the current way of right clicking and doing new, that also has benefits.

In the end it is just a choice of what kind of users you want to address primarily - and the amount of coding for you :-(

The new "help" button is ok - but only for users who read - not for the impatient ones.

It's your project - your decision - keep up the good work 🥇 - don't be distracted by my comments from the side line!

maarten-pennings avatar Apr 16 '22 13:04 maarten-pennings