Azure / azure-dev

A developer CLI that reduces the time it takes for you to get started on Azure. The Azure Developer CLI (azd) provides a set of developer-friendly commands that map to key stages in your workflow - code, build, deploy, monitor, repeat.
https://aka.ms/azd
MIT License
416 stars 204 forks source link

Getting Started UX Improvements #4032

Open kristenwomack opened 5 months ago

kristenwomack commented 5 months ago

This is an epic level issue organizing all of the findings and actions we plan to take from the Getting Started with azd Study.

Understanding the Azure Developer CLI (azd)

Installing azd

image

Finding a template (docs or azd template list)

azd template list output is overwhelming

Initializing my project (azd init)

Several participants ran init in a non-empty directory and were surprised when the template files scattered among their existing files (vs than in a contained folder). "Would have preferred if it went into a folder kind of like how GitHub does when you clone things."

Deploying my app (azd up)

45% of participants failed running azd up for the first time because they were not logged in. The participants that succeeded were either following the Learn Modules or template's README (both have an explicit azd auth login step.

azd up takes a long time About 1/3 of participants made a comment that azd up took longer than they would expect; azd up took over 10 minutes to complete for 4 out of 9 participants

Participants noticed a disconnect between deployment status in the Azure Portal versus azd. Developers said they want to trust the status in the Azure Portal over the command line. There is no clear suggestion here at the moment.

Running my app on Azure

Participants had trouble finding their app's endpoint in the azd deploy output 3 of 9 participants went to the Azure Portal looking for their endpoint. All of them followed the last link in the terminal output taking them to the Resource Group.

Set up a pipeline (azd pipeline config)

Successfully setting up their pipeline easily and quickly was a wow moment for the participants that tried this step. The training module includes a unit for configuring CI/CD, but the quick start does not.

Learn Modules

General improvements to consider:

Reference file: https://microsoft-my.sharepoint.com/:p:/p/gracekulin/EdVo163lJ-ZOulRALX4b_NUBAAksQ6uShQ2LyQHzDpyMFg?e=4OVjuC

cc: @gkulin @SophCarp @Austinauth

SophCarp commented 4 months ago

Related item: https://github.com/rnd-pm-ux-design-amandas/d3-devex-work-items/issues/716 Design experience audit

Austinauth commented 4 months ago

Please see #3964 for template list improvements.