publiccode-editor icon indicating copy to clipboard operation
publiccode-editor copied to clipboard

UX: The file upload flow is a bit confusing

Open tomootes opened this issue 8 months ago • 7 comments

When uploading an existing publiccode.yml file, the flow is a bit confusing.

  1. I open the editor:
  • I would like to upload my existing pc.yml file so i'm looking for a button that says "Upload", instead i find a button that says "Load". This is a but confusing.
  1. I click the "load"-button
  • A drawer opens with two tabs: "File" and "Remote". These could be more precise to inform the user. I would prefer: "Upload file" and "From remote url"
  1. I click the "Browse"-button and select a local pc.yml file. I expect the UI to load the pc.yml-file right away. Instead i still have to click the "import"-button. Since there is an alert saying "This operation will erase all data" i see no harm in firing this event right away.

Recommendations

  • Rename upload button to "Upload"
  • Rename "file"-tab to "Upload file"
  • Rename "remote"-tab to "From remote url"
  • Rename "Browse file from disk" to "Browse file"
  • As seen as user has selected a file, load the contents into the editor

tomootes avatar May 13 '25 08:05 tomootes

@tomootes hi. Thanks for your suggestion. I get it and this is a good topic for the team of designers.

valeriocomo avatar Jun 09 '25 16:06 valeriocomo

Alright! If i can review a design somewhere, hit me up :)

tomootes avatar Jun 10 '25 09:06 tomootes

I agree with all @tomootes' recomendations.

@valeriocomo, just adding: the need to press "Import" is even more confusing (dangerously so) when you already loaded something in the editor and don't realize that selecting the file from your OS' file dialog is not enough to upload it.

The only feedback when you upload a file is the editor being populated with data and if you already have something that doesn't work and you might think it was uploaded, when in reality the editor wants you to press "Import"."

"Import" and "This operation will erase all data" need to go.

bfabio avatar Sep 24 '25 14:09 bfabio

@bfabio we had a meeting with Designers. we discussed about this issue and we'll work on an improved version. @tomootes and I had already talked about this topic in a 1vs1 meeting. I'm aware that this solution isn't user friendly.

valeriocomo avatar Sep 24 '25 15:09 valeriocomo

@valeriocomo thanks for the heads-up

tomootes avatar Sep 25 '25 07:09 tomootes

as output of a meeting with Designers team, we'll delivery the following changes:

  • back button will be always shown at the left side
  • browser button and import button will be in the same context. it will be disabled until a file is selected
  • filename will be displayed
  • reset selection button will be added beside the filename
  • the "overwrite" modal will be showed if and only if the form has already filled
  • it will displayed a feedback message at the end of the process, telling the user if the import process was successful or not.

no mockup are available.

valeriocomo avatar Sep 30 '25 09:09 valeriocomo

  • filename will be displayed

  • reset selection button will be added beside the filename

It could be worth revisiting this part: once the file is selected, there's no need to confirm it again because the selection itself serves as confirmation

bfabio avatar Oct 11 '25 06:10 bfabio