More updates

justin808 · justin808 · commit 29f37b68d6fb · 2025-09-23T21:20:13.000-10:00
diff --git a/docs/README.md b/docs/README.md
@@ -32,9 +32,8 @@ Jump to what you need
 
 ### 🏗️ **Migrating from Other Solutions**
 
-- **[From react-rails](./guides/migration/from-react-rails.md)**
-- **[From Webpacker](./guides/migration/from-webpacker.md)**
-- **[From custom setup](./guides/migration/from-custom.md)**
+- **[From react-rails](./additional-details/migrating-from-react-rails.md)** - Switch from the react-rails gem
+- **[Upgrading React on Rails](./guides/upgrading-react-on-rails.md)** - Version upgrade guide
 
 ## 🎯 Popular Use Cases
 
@@ -158,8 +157,7 @@ Find guidance for your specific scenario:
 ### Migration Guides
 
 - [Upgrading React on Rails](./guides/upgrading-react-on-rails.md)
-- [From Webpacker to Shakapacker](./guides/migration/webpacker-to-shakapacker.md)
-- [From react-rails](./guides/migration/from-react-rails.md)
+- [From react-rails gem](./additional-details/migrating-from-react-rails.md)
 
 ### Troubleshooting
 
diff --git a/docs/additional-details/recommended-project-structure.md b/docs/additional-details/recommended-project-structure.md
@@ -19,7 +19,7 @@ you should consider keeping your codebase mostly consistent with the defaults fo
 
 1. Move the directory:
 
-```sh
+```bash
 mv app/javascript client
 ```
 
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -27,10 +27,11 @@ The best way to understand React on Rails depends on your situation:
 
 ## System Requirements
 
+✅ **🚨 React on Rails 16.0+** (this guide covers modern features)
+✅ **🚨 Shakapacker 7+** (required for React on Rails 16)
 ✅ **Rails 7+** (Rails 5+ supported)
 ✅ **Ruby 3.0+** (Ruby 2.7+ supported)
 ✅ **Node.js 18+**
-✅ **Shakapacker 7** (or Shakapacker 6 with [special setup](./additional-details/tips-for-usage-with-sp6.md))
 
 > **Don't have Shakapacker?** It's the modern replacement for Webpacker and required for React on Rails.
 
diff --git a/docs/guides/rails-webpacker-react-integration-options.md b/docs/guides/rails-webpacker-react-integration-options.md
@@ -142,7 +142,7 @@ You can see an example commit of adding this [here](https://github.com/shakacode
 
 1. Add the `react-hot-loader` and ` @hot-loader/react-dom` npm packages.
 
-   ```sh
+   ```bash
    yarn add --dev react-hot-loader @hot-loader/react-dom
    ```
 
diff --git a/docs/javascript/capistrano-deployment.md b/docs/javascript/capistrano-deployment.md
@@ -12,7 +12,7 @@ end
 
 Then run Bundler to ensure Capistrano is downloaded and installed:
 
-```sh
+```bash
 bundle install
 ```
 
diff --git a/docs/planning/DOCS_PR_SUMMARY.md b/docs/planning/DOCS_PR_SUMMARY.md
diff --git a/docs/planning/DOCUMENTATION_IMPROVEMENT_PLAN.md b/docs/planning/DOCUMENTATION_IMPROVEMENT_PLAN.md
diff --git a/docs/quick-start/README.md b/docs/quick-start/README.md
@@ -8,8 +8,10 @@ This guide will have you rendering React components in your Rails app as quickly
 
 Before starting, make sure you have:
 
-- **Rails 7+** application
-- **Ruby 3.0+**
+- **🚨 React on Rails 16.0+** (this guide)
+- **🚨 Shakapacker 7+** (required for React on Rails 16)
+- **Rails 7+** application (Rails 5+ supported)
+- **Ruby 3.0+** (Ruby 2.7+ supported)
 - **Node.js 18+** and **Yarn**
 - **Basic familiarity** with React and Rails
 
@@ -132,9 +134,11 @@ Note, your layout needs to include this in the <head>:
 That's it! React on Rails will automatically:
 
 - ✅ Find your component in any directory named `ror_components` (configurable)
-- ✅ Create the webpack bundle
-- ✅ Register the component
-- ✅ Include the JavaScript on the page
+- ✅ Create optimized webpack bundles with code splitting
+- ✅ Register the component for immediate use
+- ✅ Include only necessary JavaScript on each page (reduces bundle size)
+
+> **🚀 Performance Tip:** Auto-bundling automatically optimizes your JavaScript delivery by only loading components used on each page, significantly reducing initial bundle size compared to manual bundling.
 
 Restart your server and visit the page - you should see your interactive counter!
 
