Rename understanding-react-on-rails.md to using-react-on-rails.md

Rationale:
- "understanding" is vague and confusing next to how-react-on-rails-works.md
- "using" clearly indicates practical usage guide
- Better distinction: how-react-on-rails-works.md (architecture) vs using-react-on-rails.md (practical usage)

Changes:
- Renamed docs/getting-started/understanding-react-on-rails.md → using-react-on-rails.md
- Updated link in quick-start.md
- Updated references in ia-redesign-live.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: ihabadham

docs/getting-started/quick-start.md

@@ -159,7 +159,7 @@ Now that you have React on Rails working, here's what to explore next:
 
 ### Immediate Next Steps
 
-1. **[Understanding React on Rails](./understanding-react-on-rails.md)** - Core concepts explained
+1. **[Using React on Rails](./using-react-on-rails.md)** - Core concepts explained
 2. **[View Helpers API](../api-reference/view-helpers-api.md)** - Learn all the options for `react_component`
 3. **[Hot Module Replacement](../building-features/hmr-and-hot-reloading-with-the-webpack-dev-server.md)** - Optimize your dev workflow
 

docs/getting-started/understanding-react-on-rails.md renamed to docs/getting-started/using-react-on-rails.md

@@ -330,11 +330,13 @@ After Steps 1-8, found 12 files not in original plan. Investigated and reorganiz
 ### Actions Completed:
 
 1. **✅ Deleted orphaned `docs/guides/advanced/README.md`**
+
    - Navigation index left behind after reorganization
    - Linked to files now in core-concepts/
    - Redundant, deleted
 
 2. **✅ Created `docs/introduction.md`** - New unified homepage
+
    - Explains what React on Rails is and why use it
    - When to use / when not to use decision guide
    - Three clear paths: Quick Start, Installation, Tutorial
@@ -348,12 +350,14 @@ After Steps 1-8, found 12 files not in original plan. Investigated and reorganiz
    - Built from: overview.md, doctrine.md, README.md structure
 
 3. **✅ Deleted `docs/core-concepts/react-on-rails-overview.md`**
+
    - Content consolidated into introduction.md
    - Outdated prerequisites (Rails >=5 vs current Rails 7+)
    - Created confusion with two similar entry points
    - Updated 2 links: home.md and doctrine.md
 
 4. **✅ Simplified `docs/README.md`** for GitHub users
+
    - Reduced from 173 lines to 65 lines
    - Directs to website first
    - Kept valuable learning paths from PR #1813
@@ -363,12 +367,13 @@ After Steps 1-8, found 12 files not in original plan. Investigated and reorganiz
    - Purpose: Serves GitHub users browsing repo, not website visitors
 
 5. **✅ Deleted `docs/home.md`**
+
    - Was the current website homepage (29 lines of links)
    - Replaced by introduction.md
    - All valuable content already in introduction.md or README.md
    - No unique content lost
 
-6. **✅ Transformed `docs/getting-started.md` → `docs/getting-started/understanding-react-on-rails.md`**
+6. **✅ Transformed `docs/getting-started.md` → `docs/getting-started/using-react-on-rails.md`**
    - Reduced from 253 to 238 lines (still comprehensive but focused)
    - Removed: Choose Starting Point (redundant), System Requirements (duplicate), More Reading (navigation)
    - Transformed installation section to conceptual overview with links
@@ -379,6 +384,7 @@ After Steps 1-8, found 12 files not in original plan. Investigated and reorganiz
    - Deleted original `docs/getting-started.md`
 
 **Remaining Entry Point Tasks:**
+
 - Update website config (sc-website gatsby-node.js) to use introduction.md as homepage
 
 **Next Actions:** Update website config when ready (keeping for last as user requested)
@@ -392,7 +398,7 @@ docs/
 ├── introduction.md              # ✅ Created - new unified homepage
 ├── README.md                    # ✅ Simplified for GitHub users
 ├── getting-started/ (5 files)
-│   ├── understanding-react-on-rails.md  # ✅ NEW - Transformed from getting-started.md
+│   ├── using-react-on-rails.md  # ✅ NEW - Transformed from getting-started.md
 │   ├── quick-start.md
 │   ├── installation-into-an-existing-rails-app.md
 │   ├── tutorial.md