Fix broken links and reconcile version requirements

- Update 20+ broken links in docs/README.md to point to existing files
- Fix 5 broken links in docs/quick-start/README.md
- Fix image path in docs/getting-started.md (../images -> ./images)
- Update Storybook URL to current domain (getstorybook.io -> storybook.js.org)
- Reconcile version requirements across docs to match gemspec:
  - Shakapacker 6+ (7+ recommended) instead of "7+ required"
  - Ruby 3.0+ (required) instead of "Ruby 2.7+ supported"
  - Rails 5.2+ supported for consistency

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

Co-Authored-By: Claude <noreply@anthropic.com>

Author: justin808

docs/README.md

@@ -26,7 +26,7 @@ Perfect if you're new to React on Rails
 
 Jump to what you need
 
-- **[Installation Guide](./guides/installation.md)** - Detailed setup
+- **[Installation Guide](./guides/installation-into-an-existing-rails-app.md)** - Detailed setup
 - **[API Reference](./api/README.md)** - Quick lookup
 - **[Advanced Features](./guides/advanced/README.md)** - SSR, Redux, Router
 
@@ -68,22 +68,22 @@ Find guidance for your specific scenario:
 ### Development
 
 - **[Hot Module Replacement](./guides/hmr-and-hot-reloading-with-the-webpack-dev-server.md)** - Fast development workflow
-- **[Testing](./guides/development/testing.md)** - Testing React components
-- **[Debugging](./guides/development/debugging.md)** - Common debugging techniques
+- **[Testing](./guides/rspec-configuration.md)** - Testing React components
+- **[Debugging](./javascript/troubleshooting-build-errors.md)** - Common debugging techniques
 
 ### Deployment & Performance
 
 - **[Deployment](./guides/deployment.md)** - Production deployment guide
-- **[Performance](./guides/performance/README.md)** - Optimization techniques
-- **[Bundle Optimization](./guides/performance/webpack-bundle-optimization.md)** - Reduce bundle size
+- **[Performance](./guides/webpack-configuration.md)** - Optimization techniques
+- **[Bundle Optimization](./guides/webpack-configuration.md)** - Reduce bundle size
 
 ## 🆘 Need Help?
 
 ### Quick Solutions
 
 - **[Troubleshooting Guide](./troubleshooting/README.md)** - Common issues and solutions
-- **[FAQ](./troubleshooting/faq.md)** - Frequently asked questions
-- **[Error Messages](./troubleshooting/error-messages.md)** - Decode error messages
+- **[FAQ](./troubleshooting/README.md)** - Frequently asked questions
+- **[Error Messages](./javascript/troubleshooting-build-errors.md)** - Decode error messages
 
 ### Community Support
 
@@ -110,7 +110,7 @@ Find guidance for your specific scenario:
 
 - [View Helpers API](./api/view-helpers-api.md)
 - [Redux Store API](./api/redux-store-api.md)
-- [Configuration API](./api/configuration-api.md)
+- [JavaScript API](./api/javascript-api.md)
 
 ### Guides
 
@@ -122,37 +122,37 @@ Find guidance for your specific scenario:
 
 #### Core Features
 
-- [Server-Side Rendering](./guides/fundamentals/server-rendering.md)
-- [Component Registration](./guides/fundamentals/component-registration.md)
+- [Server-Side Rendering](./guides/react-server-rendering.md)
+- [Component Registration](./guides/render-functions-and-railscontext.md)
 - [Props and RailsContext](./guides/render-functions-and-railscontext.md)
 
 #### State Management
 
-- [Redux Integration](./guides/state-management/redux.md)
-- [Context API](./guides/state-management/context-api.md)
+- [Redux Integration](./javascript/react-and-redux.md)
+- [Context API](./guides/render-functions-and-railscontext.md)
 
 #### Routing
 
-- [React Router Setup](./guides/routing/react-router.md)
-- [Server-Side Routing](./guides/routing/server-side-routing.md)
+- [React Router Setup](./javascript/react-router.md)
+- [Server-Side Routing](./guides/react-server-rendering.md)
 
 #### Advanced Topics
 
 - [Webpack Configuration](./guides/webpack-configuration.md)
 - [Code Splitting](./javascript/code-splitting.md)
-- [Performance Optimization](./guides/performance/README.md)
+- [Performance Optimization](./guides/webpack-configuration.md)
 
 #### Development
 
-- [Hot Module Replacement](./guides/development/hot-reloading.md)
-- [Testing Components](./guides/development/testing.md)
-- [Debugging](./guides/development/debugging.md)
+- [Hot Module Replacement](./guides/hmr-and-hot-reloading-with-the-webpack-dev-server.md)
+- [Testing Components](./guides/rspec-configuration.md)
+- [Debugging](./javascript/troubleshooting-build-errors.md)
 
 #### Deployment
 
-- [Production Setup](./guides/deployment/README.md)
-- [Heroku Deployment](./guides/deployment/heroku-deployment.md)
-- [Docker Setup](./guides/deployment/docker.md)
+- [Production Setup](./guides/deployment.md)
+- [Heroku Deployment](./guides/deployment.md)
+- [Docker Setup](./guides/deployment.md)
 
 ### Migration Guides
 
@@ -162,11 +162,11 @@ Find guidance for your specific scenario:
 ### Troubleshooting
 
 - [Common Issues](./troubleshooting/README.md)
-- [Error Messages](./troubleshooting/error-messages.md)
-- [Performance Issues](./troubleshooting/performance.md)
+- [Error Messages](./javascript/troubleshooting-build-errors.md)
+- [Performance Issues](./javascript/troubleshooting-build-errors.md)
 
 ### Contributing
 
 - [Contributing Guide](../CONTRIBUTING.md)
-- [Development Setup](./contributor-info/development.md)
-- [Pull Request Guidelines](./contributor-info/pull-requests.md)
+- [Development Setup](../CONTRIBUTING.md)
+- [Pull Request Guidelines](../CONTRIBUTING.md)

docs/getting-started.md

@@ -28,9 +28,9 @@ 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)
+✅ **🚨 Shakapacker 6+** (7+ recommended for React on Rails 16)
+✅ **Rails 7+** (Rails 5.2+ supported)
+✅ **Ruby 3.0+** (required)
 ✅ **Node.js 18+**
 
 > **Don't have Shakapacker?** It's the modern replacement for Webpacker and required for React on Rails.
@@ -165,7 +165,7 @@ The generator set up the following:
 2. Rails integration for rendering this component in a Rails view
 3. Webpack configuration for building your JavaScript bundle
 
-![Basic Hello World Example](../images/bundle-splitting-hello-world.png)
+![Basic Hello World Example](./images/bundle-splitting-hello-world.png)
 
 #### Different Server-Side Rendering Code (and a Server-Specific Bundle)
 

docs/javascript/angular-js-integration-migration.md

@@ -20,7 +20,7 @@ Check out the [ngReact](https://github.com/ngReact/ngReact) package. This packag
 
 ## StoryBook
 
-We love using [StoryBook](https://getstorybook.io/) to create a simple testing and inspection area of new React components as we migrate them over from AngularJS Components.
+We love using [Storybook](https://storybook.js.org/) to create a simple testing and inspection area of new React components as we migrate them over from AngularJS Components.
 
 ## Overall Approach?
 

docs/quick-start/README.md

@@ -9,9 +9,9 @@ This guide will have you rendering React components in your Rails app as quickly
 Before starting, make sure you have:
 
 - **🚨 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)
+- **🚨 Shakapacker 6+** (7+ recommended for React on Rails 16)
+- **Rails 7+** application (Rails 5.2+ supported)
+- **Ruby 3.0+** (required)
 - **Node.js 18+** and **Yarn**
 - **Basic familiarity** with React and Rails
 
@@ -161,18 +161,18 @@ Now that you have React on Rails working, here's what to explore next:
 
 1. **[Basic Configuration](../getting-started.md)** - Understand the setup
 2. **[View Helpers API](../api/view-helpers-api.md)** - Learn all the options for `react_component`
-3. **[Hot Module Replacement](../guides/development/hot-reloading.md)** - Optimize your dev workflow
+3. **[Hot Module Replacement](../guides/hmr-and-hot-reloading-with-the-webpack-dev-server.md)** - Optimize your dev workflow
 
 ### Dive Deeper
 
 1. **[Complete Tutorial](../guides/tutorial.md)** - Build a full app with Redux
-2. **[Server-Side Rendering](../guides/fundamentals/server-rendering.md)** - Optimize for SEO and performance
-3. **[Production Deployment](../guides/deployment/README.md)** - Deploy to production
+2. **[Server-Side Rendering](../guides/react-server-rendering.md)** - Optimize for SEO and performance
+3. **[Production Deployment](../guides/deployment.md)** - Deploy to production
 
 ### Advanced Features
 
-1. **[Redux Integration](../guides/state-management/redux.md)** - Manage application state
-2. **[React Router](../guides/routing/react-router.md)** - Client-side routing
+1. **[Redux Integration](../javascript/react-and-redux.md)** - Manage application state
+2. **[React Router](../javascript/react-router.md)** - Client-side routing
 3. **[Code Splitting](../javascript/code-splitting.md)** - Optimize bundle size
 
 ## 🆘 Need Help?