search

microsoft / vscode-azurestaticwebapps

Azure Static Web Apps extension for VS Code
https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurestaticwebapps
MIT License
92 stars 35 forks source link

"Create Static Web App..." command and icon is confusing for users #580

Open alexweininger opened 2 years ago

alexweininger commented 2 years ago

image

In multiple user studies we've observed that users are don't understand what this button and the "Create Static Web App..." command does.

  1. Users have a local static web app in their workspace, and are ready to deploy it to Azure.
  2. Users see this button and hover over it, but they think that it means to create a new static web app locally, e.g. to scaffold out a basic React, Angular, etc. app
  3. They end up not clicking it and get stuck on how to deploy
  4. Some users did come back to it after reading the docs

I think the best thing would be to change the icon and command name to this:

https://user-images.githubusercontent.com/12476526/141540859-4589bd66-5730-4561-9563-9043e790fddb.mov

Only downside about making this change is a lot of docs, images, and probably learn modules would suddenly become outdated... We'll have to gauge the priority on this change with that in mind I guess.

cc: @simonaco

anthonychu commented 2 years ago

Docs changes aren’t that bad as long as we identify them and get them ready before the changes take effect.

The term “deploy” could be misleading too. People might click it thinking they can update an existing app (especially if you’re used to the deploy command in the Azure Functions extension). We might also one day have a deploy/publish gesture. Agreed that the existing button is confusing but wanted to take these points into consideration.