The problem

The docs listed every command alphabetically. New users knew what they wanted to do, but not which command did it.

What I changed

I reorganized the site around tasks like deploying a preview or rolling back, with the reference pages kept one click away.

Examples that work

Every example runs in CI before each release, so copied snippets always match the current version of the tool.

What I learned. People look for the task they want to finish, not the command name. Organising the docs around tasks cleared up most of the confusion.

What happened

Support requests about basic setup went down, and the docs became the most visited part of the site.