microsoft / microsoft/vscode-azurestaticwebapps

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

Open
#580 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
99
Forks
39
Avg merge
3d 7h
Merged PRs (30d)
2

Description

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

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the extension's contribution for the "Create Static Web App..." command and its icon, then review the linked screenshots and proposed wording. Identify documentation, images, and learn modules that reference the current command or icon; done means the UI is clearer and those references are updated or their impact is explicitly accounted for.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, typescript, vscode
Domain
design, developer-experience, tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.