Rebase examples catalog onto current site page

Author: justin808

prototypes/docusaurus/src/pages/examples.tsx

@@ -2,6 +2,7 @@ import type {ReactNode} from 'react';
 import Link from '@docusaurus/Link';
 import Layout from '@theme/Layout';
 
+import {docsRoutes} from '../constants/docsRoutes';
 import styles from './examples.module.css';
 
 const decisionPaths = [
@@ -10,45 +11,24 @@ const decisionPaths = [
     title: 'Start a new Rails + React app',
     description:
       'Use the create-app and quick-start docs first, then compare the maintained starter repos for SSR + HMR or React on Rails Pro + RSC.',
-    href: '/docs/getting-started/create-react-on-rails-app',
+    href: docsRoutes.docsGuide,
     cta: 'Open starter docs',
   },
   {
     eyebrow: 'Migration path',
     title: 'Move from react-rails',
     description:
       'Use the migration guide together with the maintained migration reference repos instead of reconstructing the process from older blog posts.',
-    href: '/docs/migrating/migrating-from-react-rails',
+    href: docsRoutes.migrateFromReactRails,
     cta: 'Use the migration guide',
   },
   {
     eyebrow: 'Pro path',
     title: 'Evaluate React on Rails Pro + RSC',
     description:
-      'Start with the Pro docs, then use the public RSC and benchmark demos to judge where the added complexity pays for itself.',
-    href: '/docs/pro/react-server-components/tutorial',
-    cta: 'Evaluate Pro + RSC',
-  },
-];
-
-const namingPattern = [
-  {
-    title: 'Demo repos',
-    pattern: 'react-on-rails-demo-*',
-    description:
-      'Use for evaluation apps, benchmarks, feature showcases, and product comparisons.',
-  },
-  {
-    title: 'Example repos',
-    pattern: 'react-on-rails-example-*',
-    description:
-      'Use for focused implementation references, migrations, and narrowly scoped technical patterns.',
-  },
-  {
-    title: 'Tutorial repos',
-    pattern: 'react-on-rails-tutorial-*',
-    description:
-      'Use for repos that map directly to a docs flow, workshop, or educational sequence.',
+      'Start with the OSS vs Pro guide, then use the public RSC demos to judge where the added complexity pays for itself.',
+    href: docsRoutes.ossVsPro,
+    cta: 'Compare OSS and Pro',
   },
 ];
 
@@ -81,7 +61,7 @@ const catalogSections = [
     eyebrow: 'Migrations',
     title: 'Adoption and migration references',
     description:
-      'Use these when your question is not "how do I start?" but "how do I move an existing app?"',
+      'Use these when your question is not “how do I start?” but “how do I move an existing app?”',
     items: [
       {
         title: 'react-rails migration example',
@@ -105,7 +85,7 @@ const catalogSections = [
     eyebrow: 'React on Rails Pro',
     title: 'RSC and performance demos',
     description:
-      'These are the demos to reach for when the conversation is about React on Rails Pro, React Server Components, and measured user-visible wins.',
+      'These public demos use React on Rails Pro and React Server Components. Reach for them when the conversation is about measured user-visible wins.',
     items: [
       {
         title: 'Hacker News RSC demo',
@@ -123,13 +103,21 @@ const catalogSections = [
         href: 'https://github.com/shakacode/react-server-components-marketplace-demo',
         tags: ['Pro', 'RSC', 'Performance'],
       },
+    ],
+  },
+  {
+    eyebrow: 'Legacy',
+    title: 'Historical full-app reference',
+    description:
+      'This repo is still useful when you want to see an older production-style app, but it is no longer the recommended starting point for new work.',
+    items: [
       {
-        title: 'Gumroad comparison demo',
-        repo: 'gumroad-rsc',
+        title: 'react-webpack-rails-tutorial',
+        repo: 'react-webpack-rails-tutorial',
         description:
-          'Benchmark-oriented comparison between an Inertia-style surface and a React on Rails Pro + RSC surface on the same product domain.',
-        href: 'https://github.com/shakacode/gumroad-rsc',
-        tags: ['Pro', 'RSC', 'Benchmark'],
+          'Older full-app reference with a live demo at reactrails.com. Keep this for historical context rather than as the primary starter.',
+        href: 'https://github.com/shakacode/react-webpack-rails-tutorial',
+        tags: ['Legacy', 'Full App'],
       },
     ],
   },
@@ -173,26 +161,6 @@ export default function ExamplesPage(): ReactNode {
           </div>
         </section>
 
-        <section className="container">
-          <div className={styles.sectionHeader}>
-            <p className={styles.sectionEyebrow}>Naming pattern</p>
-            <h2>Use predictable prefixes for public React on Rails repos.</h2>
-            <p className={styles.sectionLead}>
-              The catalog is moving toward clearer prefixes so GitHub filtering and docs curation
-              stay simple.
-            </p>
-          </div>
-          <div className={styles.patternGrid}>
-            {namingPattern.map((entry) => (
-              <article className={styles.card} key={entry.pattern}>
-                <h3>{entry.title}</h3>
-                <p className={styles.pattern}>{entry.pattern}</p>
-                <p>{entry.description}</p>
-              </article>
-            ))}
-          </div>
-        </section>
-
         {catalogSections.map((section) => (
           <section className="container" key={section.title}>
             <div className={styles.sectionHeader}>
@@ -227,8 +195,7 @@ export default function ExamplesPage(): ReactNode {
             <p className={styles.sectionEyebrow}>Source of truth</p>
             <h2>Use the docs for taxonomy and this page for curation.</h2>
             <p className={styles.sectionLead}>
-              The canonical docs page for repo taxonomy lives in
-              {' '}
+              The canonical docs page for repo taxonomy lives in{' '}
               <Link to="/docs/getting-started/examples-and-references">
                 Examples and migration references
               </Link>