Move docs home copy upstream and fix tutorial anchor (#2671)

Moves the canonical docs-home copy into `docs/README.md` so
`reactonrails.com` no longer has to own that prose in
`prepare-docs.mjs`.

Also fixes the tutorial table-of-contents anchor so it points to the
existing `What's Next?` section instead of the stale `#conclusion`
anchor.

- Replaces the generic docs README with the canonical docs landing
content used by the site
- Keeps the GitHub-friendly docs website link in the upstream README
- Fixes `docs/oss/getting-started/tutorial.md` TOC link from
`#conclusion` to `#whats-next`

This is the remaining upstream/site-boundary cleanup from the docs work.
The site repo should present docs, not own canonical docs content.

- `reactonrails.com`: `npm run prepare`
- `reactonrails.com`: `npm run build`

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk: documentation-only restructuring and link/anchor fixes with
no runtime code changes.
>
> **Overview**
> Updates `docs/README.md` from a GitHub navigation stub to a more
opinionated docs landing page that explains OSS vs Pro, reorganizes
entry points by user intent, and adds Pro evaluation/help links.
>
> Fixes the tutorial table-of-contents to link to the existing **“What’s
Next?”** section (`#whats-next`) instead of a stale conclusion anchor.
>
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
2cc798e. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

* **Documentation**
* Renamed top-level docs to "Documentation Guide" and reframed intro to
present OSS vs Pro paths with selection criteria.
* Reorganized navigation into path-oriented sections (new app,
add-to-app, OSS→Pro evaluation) and consolidated deeper links.
* Reduced main Pro feature listings, updated help links, and added a
friendly evaluation policy.
  * Tutorial TOC anchor changed: "Conclusion" → "What's Next?"
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: justin808

docs/README.md

@@ -1,78 +1,53 @@
-# React on Rails Documentation
+# Documentation Guide
 
-> For the best experience, visit our **[documentation website](https://reactonrails.com/docs/)**.
+React on Rails is one product with two tiers: open source for Rails + React integration, and Pro when you need higher SSR throughput, deeper RSC support, or maintainer-backed help.
 
-Browsing on GitHub? This guide will help you navigate the documentation.
+## Choose the path that matches your app
 
-## Open Source (OSS)
+### Starting a new Rails + React app
 
-The core React on Rails gem and npm package.
+- [Create a new app](./oss/getting-started/create-react-on-rails-app.md)
+- [Quick Start](./oss/getting-started/quick-start.md)
+- [Tutorial — build a complete app](./oss/getting-started/tutorial.md)
 
-### Learning Paths
+### Adding React to an existing Rails app
 
-**New to React on Rails?**
+- [Install into an existing Rails app](./oss/getting-started/installation-into-an-existing-rails-app.md)
+- [Render your first component](./oss/getting-started/using-react-on-rails.md)
 
-1. [Introduction](./oss/introduction.md) - What is React on Rails and why use it?
-2. [Quick Start](./oss/getting-started/quick-start.md) - Get your first component running in 15 minutes
-3. [Tutorial](./oss/getting-started/tutorial.md) - Build a complete app with Redux and routing
+### Already using React on Rails OSS?
 
-**Experienced developers:**
+- [Compare OSS and Pro](./oss/getting-started/oss-vs-pro.md)
+- [Upgrade to Pro](./pro/upgrading-to-pro.md)
 
-- [Installation Guide](./oss/getting-started/installation-into-an-existing-rails-app.md) - Add to existing Rails app
-- [Compare React on Rails to alternatives](./oss/getting-started/comparing-react-on-rails-to-alternatives.md) - Evaluate Hotwire, Inertia Rails, and react-rails
-- [API Reference](./oss/api-reference/view-helpers-api.md) - View helpers and JavaScript API
-- [Configuration](./oss/configuration/README.md) - All configuration options
-- [Core Concepts](./oss/core-concepts/how-react-on-rails-works.md) - Architecture and SSR
+### Evaluating Rails + React options
 
-### Categories
+- [Examples and migration references](https://reactonrails.com/examples)
+- [Compare with alternatives](./oss/getting-started/comparison-with-alternatives.md)
+- [Migrate from react-rails](./oss/migrating/migrating-from-react-rails.md)
 
-- [Getting Started](./oss/getting-started/quick-start.md) - Installation, quick start, tutorial
-- [Core Concepts](./oss/core-concepts/) - How React on Rails works, SSR, auto-bundling
-- [Building Features](./oss/building-features/) - Redux, routing, i18n, testing
-- [Configuration](./oss/configuration/README.md) - All configuration options
-- [API Reference](./oss/api-reference/) - View helpers and JavaScript API
-- [Deployment](./oss/deployment/README.md) - Production deployment and troubleshooting
-- [Upgrading](./oss/upgrading/) - Version upgrade guides
-- [Changelog](./oss/upgrading/changelog.md) - All notable changes by version
-- [Migrating](./oss/migrating/) - From other frameworks
-- [Misc](./oss/misc/) - Articles, tips, credits, and other resources
+## Dive deeper when you need it
 
-### Quick Reference
+- [Introduction](./oss/introduction.md)
+- [Core Concepts](./oss/core-concepts/how-react-on-rails-works.md)
+- [API Reference](./oss/api-reference/view-helpers-api.md)
+- [Deployment and troubleshooting](./oss/deployment/README.md)
+- [Configuration](./oss/configuration/README.md)
+- [Changelog](./oss/upgrading/changelog.md)
 
-| I want to...                           | Go here                                                                                   |
-| -------------------------------------- | ----------------------------------------------------------------------------------------- |
-| **Add React to existing Rails app**    | [Installation Guide](./oss/getting-started/installation-into-an-existing-rails-app.md)    |
-| **Compare Rails + frontend options**   | [Comparison Guide](./oss/getting-started/comparing-react-on-rails-to-alternatives.md)     |
-| **Enable server-side rendering**       | [SSR Guide](./oss/core-concepts/react-server-rendering.md)                                |
-| **Set up hot reloading**               | [HMR Setup](./oss/building-features/hmr-and-hot-reloading-with-the-webpack-dev-server.md) |
-| **Use Redux with Rails**               | [Redux Integration](./oss/building-features/react-and-redux.md)                           |
-| **Use TanStack Router**                | [TanStack Router Guide](./oss/building-features/tanstack-router.md)                       |
-| **Migrate to React Server Components** | [RSC Migration Guide](./oss/migrating/migrating-to-rsc.md)                                |
-| **Deploy to production**               | [Deployment Guide](./oss/deployment/README.md)                                            |
-| **Manage page metadata (title, meta)** | [React 19 Native Metadata](./oss/building-features/react-19-native-metadata.md)           |
-| **Troubleshoot issues**                | [Troubleshooting](./oss/deployment/troubleshooting.md)                                    |
-| **Compare OSS vs Pro features**        | [OSS vs Pro](./oss/getting-started/oss-vs-pro.md)                                         |
-| **Compare with alternatives**          | [Comparison with Alternatives](./oss/getting-started/comparison-with-alternatives.md)     |
+## Pro features
 
-## Pro
-
-Performance enhancements, React Server Components, and advanced features. Requires a [React on Rails Pro](https://pro.reactonrails.com/) subscription for production use. Contact [justin@shakacode.com](mailto:justin@shakacode.com) for startup-friendly pricing.
-
-- [Upgrading to Pro](./pro/upgrading-to-pro.md) - Switch from OSS to Pro in three steps
-- [Installation](./pro/installation.md) - Set up React on Rails Pro
-- [Configuration](./oss/configuration/configuration-pro.md) - Pro-specific settings
 - [React Server Components](./pro/react-server-components/tutorial.md) - RSC with Rails
 - [Streaming SSR](./oss/building-features/streaming-server-rendering.md) - Progressive server rendering
-- [SSR Caching](./oss/building-features/caching.md) - Prerender and fragment caching
-- [Bundle Caching](./oss/building-features/bundle-caching.md) - Avoid redundant webpack builds
 - [Node Renderer](./oss/building-features/node-renderer/basics.md) - Dedicated Node.js rendering server
-- [Code Splitting](./oss/building-features/code-splitting.md) - Loadable components
-- [Ruby API (Pro)](./oss/api-reference/ruby-api-pro.md) - Pro view helpers and utilities
-- [Upgrading Pro](./pro/updating.md) - Version upgrade guide
-- [Troubleshooting](./pro/troubleshooting.md) - Common Pro issues
+- [Upgrading to Pro](./pro/upgrading-to-pro.md) - Switch from OSS to Pro in three steps
+
+## Friendly evaluation policy
+
+- You can try React on Rails Pro without a license while evaluating.
+- If your organization is budget-constrained, [contact us](mailto:justin@shakacode.com) about free licenses.
 
-## Need Help?
+## Need more help?
 
-- [Troubleshooting Guide](./oss/deployment/troubleshooting.md) - Common issues and solutions
-- [GitHub Discussions](https://github.com/shakacode/react_on_rails/discussions) - Ask questions
-- [React on Rails Pro](https://pro.reactonrails.com/) - Advanced features and professional support
+- [GitHub Discussions](https://github.com/shakacode/react_on_rails/discussions)
+- [Documentation website](https://reactonrails.com/docs/)

docs/oss/getting-started/tutorial.md

@@ -40,7 +40,7 @@ By the time you read this, the latest may have changed. Be sure to check the ver
     - [Moving from the Rails default `/app/javascript` to the recommended `/client` structure](#moving-from-the-rails-default-appjavascript-to-the-recommended-client-structure)
     - [Custom IP & PORT setup (Cloud9 example)](#custom-ip--port-setup-cloud9-example)
     - [RubyMine performance tip](#rubymine-performance-tip)
-- [What's Next](#whats-next)
+- [What's Next?](#whats-next)
 
 ## Installation
 
@@ -257,7 +257,6 @@ It's super important to exclude certain directories from RubyMine or else it wil
 Now that you have React on Rails running, here are ways to level up:
 
 - **Add server-side rendering** — [SSR guide](../core-concepts/react-server-rendering.md)
-- **Compare React on Rails to alternatives** — [Comparison guide](./comparing-react-on-rails-to-alternatives.md)
 - **See the feature comparison** — [OSS vs Pro](./oss-vs-pro.md)
 - **Upgrade to Pro** for React Server Components, streaming SSR, and 10-100x faster SSR — [3-step upgrade guide](../../pro/upgrading-to-pro.md)
 - **Explore the full docs** — [Documentation index](../../README.md)