clearer examples for init in docs

Author: skarim

README.md

@@ -23,12 +23,10 @@ npx skills add github/gh-stack
 ## Quick start
 
 ```sh
-# Start a new stack from the default branch
+# Start a new stack (creates and checks out the first branch)
 gh stack init
 
-# Create the first branch and start working
-gh stack add auth-layer
-# ... make commits ...
+# ... make commits on the first branch ...
 
 # Add another branch on top
 gh stack add api-endpoints
@@ -388,9 +386,8 @@ gh stack feedback "Support for reordering branches"
 ## Typical workflow
 
 ```sh
-# 1. Start a stack
+# 1. Start a stack (creates and checks out the first branch)
 gh stack init
-gh stack add auth-middleware
 
 # 2. Work on the first layer
 #    ... write code, make commits ...

docs/src/content/docs/faq.md

@@ -19,6 +19,7 @@ You can create a stack using the `gh stack` CLI:
 
 ```sh
 gh stack init
+# ... make commits on the first branch ...
 gh stack add auth-layer
 # ... make commits ...
 gh stack add api-routes

docs/src/content/docs/guides/workflows.md

@@ -10,9 +10,8 @@ This guide covers the most common workflows for day-to-day use of stacked PRs, f
 The basic flow: initialize a stack, add branches for each logical unit of work, commit, push, iterate on review feedback, and merge.
 
 ```sh
-# 1. Start a stack
+# 1. Start a stack (creates and checks out the first branch)
 gh stack init
-gh stack add auth-middleware
 
 # 2. Work on the first layer
 # ... write code, make commits ...

docs/src/content/docs/index.mdx

@@ -60,8 +60,9 @@ When you're ready to merge, you merge from the bottom up. Each PR can be merged
 # Install the CLI extension
 gh extension install github/gh-stack
 
-# Create a stack, add branches, push PRs
+# Create a stack (creates and checks out the first branch)
 gh stack init
+# ... make commits ...
 gh stack add auth-layer
 # ... make commits ...
 gh stack add api-routes