move react docs

rescript-lang · jderochervlk · Sep 28, 2025 · Sep 28, 2025 · Sep 28, 2025 · Sep 28, 2025
commit 565e2d2e904ec2fe23f0ebfacd01542bc121a28c
diff --git a/app/routes/MdxRoute.res b/app/routes/MdxRoute.res
@@ -107,11 +107,12 @@ let reactTableOfContents = () => {
     ->groupBySection
     ->Dict.mapValues(values => values->sortSection->convertToNavItems)
 
-  // Console.log(groups)
+  Console.log(groups)
 
   // these are the categories that appear in the sidebar
   let categories: array<SidebarLayout.Sidebar.Category.t> = [
     {name: "Overview", items: groups->Dict.getUnsafe("Overview")},
+    // {name: "Main concepts", items: groups->Dict.getUnsafe("Main concepts")},
   ]
 
   Console.log(categories)
@@ -164,7 +165,6 @@ let loader: Loader.t<loaderData> = async ({request}) => {
       } else if pathname->String.includes("docs/react") {
         reactTableOfContents()
       } else {
-        // TODO RR7 add react docs
         []
       }
     }

diff --git a/docs/react/arrays-and-keys.mdx b/docs/react/arrays-and-keys.mdx
@@ -2,6 +2,8 @@
 title: Arrays and Keys
 description: "Rendering arrays and handling keys in ReScript and React"
 canonical: "/docs/react/latest/arrays-and-keys"
+section: "Main Concepts"
+order: 4
 ---
 
 # Arrays and Keys

diff --git a/docs/react/beyond-jsx.mdx b/docs/react/beyond-jsx.mdx
@@ -2,6 +2,8 @@
 title: Beyond JSX
 description: "Details on how to use ReScript and React without JSX"
 canonical: "/docs/react/latest/beyond-jsx"
+section: "Guides"
+order: 1
 ---
 
 # Beyond JSX

diff --git a/docs/react/components-and-props.mdx b/docs/react/components-and-props.mdx
@@ -2,6 +2,8 @@
 title: Components and Props
 description: "Basic concepts for components and props in ReScript & React"
 canonical: "/docs/react/latest/components-and-props"
+section: "Main Concepts"
+order: 3
 ---
 
 # Components and Props

diff --git a/docs/react/context.mdx b/docs/react/context.mdx
@@ -2,6 +2,8 @@
 title: Context
 description: "Details about Context in ReScript and React"
 canonical: "/docs/react/latest/context"
+section: "Main Concepts"
+order: 7
 ---
 
 # Context

diff --git a/docs/react/elements-and-jsx.mdx b/docs/react/elements-and-jsx.mdx
@@ -2,6 +2,8 @@
 title: Elements & JSX
 description: "Basic concepts for React elements and how to use them in JSX"
 canonical: "/docs/react/latest/elements-and-jsx"
+section: "Main Concepts"
+order: 1
 ---
 
 # Elements & JSX

diff --git a/docs/react/events.mdx b/docs/react/events.mdx
@@ -2,6 +2,8 @@
 title: Events
 description: "Event handlers for React elements"
 canonical: "/docs/react/latest/events"
+section: "Main Concepts"
+order: 5
 ---
 
 # Events

diff --git a/docs/react/extensions-of-props.mdx b/docs/react/extensions-of-props.mdx
@@ -2,6 +2,8 @@
 title: Extensions of props
 description: "Extensions of props in ReScript and React"
 canonical: "/docs/react/latest/spread-props"
+section: "Guides"
+order: 3
 ---
 
 # Extensions of Props

diff --git a/docs/react/forwarding-refs.mdx b/docs/react/forwarding-refs.mdx
@@ -2,6 +2,8 @@
 title: Forwarding Refs
 description: "Forwarding Ref values in ReScript and React"
 canonical: "/docs/react/latest/forwarding-refs"
+section: "Guides"
+order: 2
 ---
 
 # Forwarding Refs

diff --git a/docs/react/hooks-context.mdx b/docs/react/hooks-context.mdx
@@ -2,6 +2,8 @@
 title: useContext Hook
 description: "Details about the useContext React hook in ReScript"
 canonical: "/docs/react/latest/hooks-context"
+section: "Hooks & State Management"
+order: 5
 ---
 
 # useContext

diff --git a/docs/react/hooks-custom.mdx b/docs/react/hooks-custom.mdx
@@ -2,6 +2,8 @@
 title: Build A Custom Hook
 description: "How to build your own hooks in ReScript & React"
 canonical: "/docs/react/latest/hooks-custom"
+section: "Hooks & State Management"
+order: 7
 ---
 
 # Build A Custom Hook

diff --git a/docs/react/hooks-effect.mdx b/docs/react/hooks-effect.mdx
@@ -2,6 +2,8 @@
 title: useEffect Hook
 description: "Details about the useEffect React hook in ReScript"
 canonical: "/docs/react/latest/hooks-effect"
+section: "Hooks & State Management"
+order: 2
 ---
 
 # useEffect

diff --git a/docs/react/hooks-overview.mdx b/docs/react/hooks-overview.mdx
@@ -2,6 +2,8 @@
 title: Hooks & State Management Overview
 description: "Overview state management and hooks in ReScript and React"
 canonical: "/docs/react/latest/hooks-overview"
+section: "Hooks & State Management"
+order: 1
 ---
 
 # Hooks Overview

diff --git a/docs/react/hooks-reducer.mdx b/docs/react/hooks-reducer.mdx
@@ -2,6 +2,8 @@
 title: useReducer Hook
 description: "Details about the useReducer React hook in ReScript"
 canonical: "/docs/react/latest/hooks-reducer"
+section: "Hooks & State Management"
+order: 4
 ---
 
 # useReducer

diff --git a/docs/react/hooks-ref.mdx b/docs/react/hooks-ref.mdx
@@ -2,6 +2,8 @@
 title: useRef Hook
 description: "Details about the useRef React hook in ReScript"
 canonical: "/docs/react/latest/hooks-ref"
+section: "Hooks & State Management"
+order: 6
 ---
 
 # useRef

diff --git a/docs/react/hooks-state.mdx b/docs/react/hooks-state.mdx
@@ -2,6 +2,8 @@
 title: useState Hook
 description: "Details about the useState React hook in ReScript"
 canonical: "/docs/react/latest/hooks-state"
+section: "Hooks & State Management"
+order: 3
 ---
 
 # useState

diff --git a/docs/react/import-export-reactjs.mdx b/docs/react/import-export-reactjs.mdx
@@ -2,6 +2,8 @@
 title: Import / Export ReactJS
 description: "Reusing existing React components"
 canonical: "/docs/react/latest/import-export-reactjs"
+section: "Main Concepts"
+order: 12
 ---
 
 # Import / Export ReactJS

diff --git a/docs/react/installation.mdx b/docs/react/installation.mdx
@@ -2,7 +2,8 @@
 title: Installation
 description: "Installation and Setup"
 canonical: "/docs/react/latest/installation"
-category: "manual"
+section: "Overview"
+order: 2
 ---
 
 # Installation

diff --git a/docs/react/introduction.mdx b/docs/react/introduction.mdx
@@ -3,6 +3,7 @@ title: Introduction
 description: "Introduction to ReScript & ReactJS"
 canonical: "/docs/react/latest/introduction"
 section: "Overview"
+order: 1
 ---
 
 # ReScript & React

diff --git a/docs/react/lazy-components.mdx b/docs/react/lazy-components.mdx
@@ -2,6 +2,8 @@
 title: Lazy Components
 description: "Details on how to use the React.lazy_ API to dynamically import components"
 canonical: "/docs/react/latest/lazy-components"
+section: "Main Concepts"
+order: 11
 ---
 
 # Lazy Components

diff --git a/docs/react/llms.mdx b/docs/react/llms.mdx
@@ -0,0 +1,23 @@
+---
+title: "LLMs"
+description: "Documentation for LLMs"
+canonical: "/docs/react/latest/llms"
+---
+
+# Documentation for LLMs
+
+We adhere to the [llms.txt convention](https://llmstxt.org/) to make documentation accessible to large language models and their applications.
+
+Currently, we have the following files...
+
+- [/docs/react/llms.txt](/llms/react/latest/llms.txt) — a list of the available files for ReScript React.
+- [/docs/react/llms-full.txt](/llms/react/latest/llm-full.txt) — complete documentation for ReScript React.
+- [/docs/react/llms-small.txt](/llms/react/latest/llm-small.txt) — compressed version of the former, without examples for ReScript React.
+
+...and the language documentation:
+
+- [/docs/manual/llms](/docs/manual/latest/llms) — the LLms documentation for ReScript.
+
+## Notes
+
+- The content is automatically generated from the same source as the official documentation for the specific version
diff --git a/docs/react/memo.mdx b/docs/react/memo.mdx
@@ -2,6 +2,8 @@
 title: memo
 description: "Using React.memo"
 canonical: "/docs/react/latest/memo"
+section: "Main Concepts"
+order: 8
 ---
 
 # memo