Simplify configuration files to improve usability

CHANGELOG.md

@@ -53,6 +53,10 @@ Changes since the last non-beta release.
 
 - **`generated_component_packs_loading_strategy` now defaults based on Pro license**: When using Shakapacker >= 8.2.0, the default loading strategy is now `:async` for Pro users and `:defer` for non-Pro users. This provides optimal performance for Pro users while maintaining compatibility for non-Pro users. You can still explicitly set the strategy in your configuration. [PR #1993](https://github.com/shakacode/react_on_rails/pull/1993) by [AbanoubGhadban](https://github.com/AbanoubGhadban).
 
+#### Documentation
+
+- **Simplified Configuration Files**: Improved configuration documentation and generator template for better clarity and usability. Reduced generator template from 67 to 42 lines (37% reduction). Added comprehensive testing configuration guide. Reorganized configuration docs into Essential vs Advanced sections. Enhanced Doctor program with diagnostics for server rendering and test compilation consistency. [PR #2011](https://github.com/shakacode/react_on_rails/pull/2011) by [justin808](https://github.com/justin808).
+
 #### Deprecated
 
 - **Node Renderer Configuration**: Renamed `bundlePath` configuration option to `serverBundleCachePath` in the node renderer to better describe its purpose and avoid confusion with Shakapacker's public bundle path. The old `bundlePath` option continues to work with deprecation warnings. Both `RENDERER_SERVER_BUNDLE_CACHE_PATH` (new) and `RENDERER_BUNDLE_PATH` (deprecated) environment variables are supported. [PR #2008](https://github.com/shakacode/react_on_rails/pull/2008) by [justin808](https://github.com/justin808).

docs/api-reference/configuration-deprecated.md

@@ -0,0 +1,52 @@
+# Deprecated Configuration Options
+
+This document lists configuration options that have been deprecated or removed from React on Rails.
+
+For current configuration options, see [configuration.md](configuration.md).
+
+## Removed Options
+
+### immediate_hydration
+
+**Status:** ⚠️ REMOVED in v17.0
+
+This configuration option has been removed. Immediate hydration is now automatically enabled for Pro users and disabled for non-Pro users.
+
+**Migration:** Remove any `config.immediate_hydration` lines from your configuration. Use per-component overrides if needed:
+
+```ruby
+# Pro users can disable for specific components:
+react_component("MyComponent", immediate_hydration: false)
+
+# Non-Pro users: immediate_hydration is ignored
+```
+
+See [CHANGELOG.md](../../CHANGELOG.md) for details.
+
+## Deprecated Options
+
+### defer_generated_component_packs
+
+**Type:** Boolean
+**Default:** `false`
+**Status:** ⚠️ DEPRECATED
+
+**Renamed to:** `generated_component_packs_loading_strategy = :defer`
+
+**Migration:**
+
+```ruby
+# Old (deprecated):
+config.defer_generated_component_packs = true
+
+# New:
+config.generated_component_packs_loading_strategy = :defer
+```
+
+See [CHANGELOG.md](../../CHANGELOG.md) for more details.
+
+## Need Help?
+
+- **Documentation:** [React on Rails Guides](https://www.shakacode.com/react-on-rails/docs/)
+- **Support:** [ShakaCode Forum](https://forum.shakacode.com/)
+- **Consulting:** [justin@shakacode.com](mailto:justin@shakacode.com)

docs/api-reference/configuration-pro.md

@@ -0,0 +1,42 @@
+# React on Rails Pro Configuration Options
+
+This document describes configuration options specific to React on Rails Pro features.
+
+For general React on Rails configuration options, see [configuration.md](configuration.md).
+
+## React Server Components (RSC)
+
+React Server Components and Streaming SSR are React on Rails Pro features.
+
+For detailed configuration of RSC and streaming features, see the Pro package documentation:
+[react_on_rails_pro/docs/configuration.md](https://github.com/shakacode/react_on_rails/blob/master/react_on_rails_pro/docs/configuration.md)
+
+> **Note:** The Pro documentation is currently maintained separately in the `react_on_rails_pro` directory. We plan to migrate and consolidate Pro documentation into the main docs structure in a future PR for better discoverability and consistency.
+
+### Key Pro Configurations
+
+These options are configured in the `ReactOnRailsPro.configure` block:
+
+- `rsc_bundle_js_file` - Path to RSC bundle
+- `react_client_manifest_file` - Client component manifest for RSC
+- `react_server_client_manifest_file` - Server manifest for RSC
+- `enable_rsc_support` - Enable React Server Components
+
+### Example Configuration
+
+```ruby
+# config/initializers/react_on_rails_pro.rb
+ReactOnRailsPro.configure do |config|
+  config.rsc_bundle_js_file = "rsc-bundle.js"
+  config.react_client_manifest_file = "client-manifest.json"
+  config.react_server_client_manifest_file = "server-manifest.json"
+  config.enable_rsc_support = true
+end
+```
+
+See the Pro documentation for complete setup instructions.
+
+## Need Help?
+
+- **Pro Features:** [React on Rails Pro](https://www.shakacode.com/react-on-rails-pro/)
+- **Consulting:** [justin@shakacode.com](mailto:justin@shakacode.com)