shakacode / shakacode/reactonrails.com

Follow-up: Align site-owned create-app and examples copy with Pro-first docs

Open
#132 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation
Dominant language
JavaScript
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

Summary

React on Rails PR #4217 changes the new-app story: npx create-react-on-rails-app my-app should now be presented as the Pro/RSC default path for React 19.2 support, with --standard as the explicit OSS-only escape hatch. The docs pages under /docs/... are sourced from shakacode/react_on_rails and should update through the existing docs-updated dispatch after that PR merges.

This issue tracks the site-owned Docusaurus pages that are not generated from the monorepo docs.

Suggested work

  • Update prototypes/docusaurus/src/constants/prompts.ts so the homepage Start a new app prompt says the default generated app is the Pro/RSC React 19.2 path, and mentions --standard only as the OSS-only escape hatch if the prompt needs that caveat.
  • Review /examples copy in prototypes/docusaurus/src/pages/examples.tsx and demo metadata in prototypes/docusaurus/src/constants/demos.ts for consistency with the Pro-first examples direction.
  • Coordinate with #129 before adding or describing the Flagship demo: do not position it as the OSS baseline unless that is still intentionally true. The React on Rails docs now treat Flagship as a product-style baseline / possible Pro-transition reference that should be checked against its README before public stack claims.
  • After PR #4217 lands and docs sync, verify the live /docs/getting-started/create-react-on-rails-app, /docs/getting-started/quick-start, and /examples pages tell one coherent new-user story.

Source

Non-goal

Do not edit generated docs directly under content/upstream/docs or prototypes/docusaurus/docs; those come from the React on Rails monorepo sync.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with prototypes/docusaurus/src/constants/prompts.ts, prototypes/docusaurus/src/pages/examples.tsx, and prototypes/docusaurus/src/constants/demos.ts, then review related issue #129 and PR #4217 for the intended Pro-first wording. After the upstream PR and docs sync, verify the create-app, quick-start, and examples pages present one consistent story without editing generated docs.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, react
Domain
content, documentation, web-dev
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.