Merge branch 'vlk/add-order-and-section-to-manual' of github.com:rescript-lang/rescript-lang.org into vlk-v12-react-router

jderochervlk · jderochervlk · commit 365d52239de0 · 2025-09-28T15:53:41.000-04:00
diff --git a/docs/manual/array-and-list.mdx b/docs/manual/array-and-list.mdx
@@ -2,6 +2,8 @@
 title: "Array & List"
 description: "Arrays and List data structures"
 canonical: "/docs/manual/v12.0.0/array-and-list"
+section: "Language Features"
+order: 12
 ---
 
 # Array and List
diff --git a/docs/manual/async-await.mdx b/docs/manual/async-await.mdx
@@ -2,6 +2,8 @@
 title: "Async / Await"
 description: "Async / await for asynchronous operations"
 canonical: "/docs/manual/v12.0.0/async-await"
+section: "Language Features"
+order: 22
 ---
 
 <!-- This prelude is used in many different followup examples, so we use it to shorten the noise of the example code. -->
diff --git a/docs/manual/attribute.mdx b/docs/manual/attribute.mdx
@@ -2,6 +2,8 @@
 title: "Attribute (Decorator)"
 description: "Annotations in ReScript"
 canonical: "/docs/manual/v12.0.0/attribute"
+section: "Language Features"
+order: 26
 ---
 
 # Attribute (Decorator)
diff --git a/docs/manual/bind-to-global-js-values.mdx b/docs/manual/bind-to-global-js-values.mdx
@@ -2,6 +2,8 @@
 title: "Bind to Global JS Values"
 description: "JS interop with global JS values in ReScript"
 canonical: "/docs/manual/v12.0.0/bind-to-global-js-values"
+section: "JavaScript Interop"
+order: 8
 ---
 
 # Bind to Global JS Values
diff --git a/docs/manual/bind-to-js-function.mdx b/docs/manual/bind-to-js-function.mdx
@@ -2,6 +2,8 @@
 title: "Bind to JS Function"
 description: "JS interop with functions in ReScript"
 canonical: "/docs/manual/v12.0.0/bind-to-js-function"
+section: "JavaScript Interop"
+order: 6
 ---
 
 # Function
diff --git a/docs/manual/bind-to-js-object.mdx b/docs/manual/bind-to-js-object.mdx
@@ -2,6 +2,8 @@
 title: "Bind to JS Object"
 description: "Interop with JS objects in ReScript"
 canonical: "/docs/manual/v12.0.0/bind-to-js-object"
+section: "JavaScript Interop"
+order: 5
 ---
 
 # Bind to JS Object
diff --git a/docs/manual/browser-support-polyfills.mdx b/docs/manual/browser-support-polyfills.mdx
@@ -2,6 +2,8 @@
 title: "Browser Support & Polyfills"
 description: "Note on browser support in ReScript"
 canonical: "/docs/manual/v12.0.0/browser-support-polyfills"
+section: "JavaScript Interop"
+order: 13
 ---
 
 # Browser Support & Polyfills
diff --git a/docs/manual/build-configuration-schema.mdx b/docs/manual/build-configuration-schema.mdx
@@ -3,6 +3,8 @@ title: "Configuration Schema"
 metaTitle: "Build System Configuration Schema"
 description: "Schema exploration widget for the ReScript configuration file"
 canonical: "/docs/manual/v12.0.0/build-configuration-schema"
+section: "Build System"
+order: 3
 ---
 
 import dynamic from "next/dynamic";
diff --git a/docs/manual/build-configuration.mdx b/docs/manual/build-configuration.mdx
@@ -3,6 +3,8 @@ title: "Configuration"
 metaTitle: "Build System Configuration"
 description: "Details about the configuration of the ReScript build system (rescript.json)"
 canonical: "/docs/manual/v12.0.0/build-configuration"
+section: "Build System"
+order: 2
 ---
 
 # Configuration
diff --git a/docs/manual/build-external-stdlib.mdx b/docs/manual/build-external-stdlib.mdx
@@ -3,6 +3,8 @@ title: "External Stdlib"
 metaTitle: "External Stdlib"
 description: "Configuring an external ReScript stdlib package"
 canonical: "/docs/manual/v12.0.0/build-external-stdlib"
+section: "Build System"
+order: 4
 ---
 
 # External Stdlib
diff --git a/docs/manual/build-overview.mdx b/docs/manual/build-overview.mdx
@@ -3,6 +3,8 @@ title: "Overview"
 metaTitle: "Build System Overview"
 description: "Documentation about the ReScript build system and its toolchain"
 canonical: "/docs/manual/v12.0.0/build-overview"
+section: "Build System"
+order: 1
 ---
 
 # Build System Overview
diff --git a/docs/manual/build-performance.mdx b/docs/manual/build-performance.mdx
@@ -3,6 +3,8 @@ title: "Performance"
 metaTitle: "Build Performance"
 description: "ReScript build performance and measuring tools"
 canonical: "/docs/manual/v12.0.0/build-performance"
+section: "Build System"
+order: 7
 ---
 
 # Build Performance
diff --git a/docs/manual/build-pinned-dependencies.mdx b/docs/manual/build-pinned-dependencies.mdx
@@ -3,6 +3,8 @@ title: "Pinned Dependencies"
 metaTitle: "Pinned Dependencies"
 description: "Handling multiple packages within one ReScript project with pinned dependencies"
 canonical: "/docs/manual/v12.0.0/build-pinned-dependencies"
+section: "Build System"
+order: 5
 ---
 
 # Pinned Dependencies
diff --git a/docs/manual/control-flow.mdx b/docs/manual/control-flow.mdx
@@ -2,6 +2,8 @@
 title: "If-Else & Loops"
 description: "If, else, ternary, for, and while"
 canonical: "/docs/manual/v12.0.0/control-flow"
+section: "Language Features"
+order: 14
 ---
 
 # If-Else & Loops
diff --git a/docs/manual/converting-from-js.mdx b/docs/manual/converting-from-js.mdx
@@ -2,6 +2,8 @@
 title: "Converting from JS"
 description: "How to convert to ReScript with an existing JS codebase"
 canonical: "/docs/manual/v12.0.0/converting-from-js"
+section: "Guides"
+order: 1
 ---
 
 # Converting from JS
diff --git a/docs/manual/dict.mdx b/docs/manual/dict.mdx
@@ -2,6 +2,8 @@
 title: "Dictionary"
 description: "Dictionary data structure in ReScript"
 canonical: "/docs/manual/v12.0.0/dict"
+section: "Language Features"
+order: 8
 ---
 
 # Dictionary
diff --git a/docs/manual/editor-code-analysis.mdx b/docs/manual/editor-code-analysis.mdx
@@ -3,6 +3,8 @@ title: "Dead Code Analysis in ReScript"
 metaTitle: "Dead Code Analysis in ReScript"
 description: "Documentation about ReScript editor plugins and code analysis"
 canonical: "/docs/manual/v12.0.0/editor-plugins"
+section: "Guides"
+order: 2
 ---
 
 # Dead Code Analysis in ReScript
diff --git a/docs/manual/editor-plugins.mdx b/docs/manual/editor-plugins.mdx
@@ -3,6 +3,8 @@ title: "Editor"
 metaTitle: "Editor"
 description: "Documentation about ReScript editor plugins and code analysis"
 canonical: "/docs/manual/v12.0.0/editor-plugins"
+section: "Overview"
+order: 3
 ---
 
 # Editor
diff --git a/docs/manual/embed-raw-javascript.mdx b/docs/manual/embed-raw-javascript.mdx
@@ -2,6 +2,8 @@
 title: "Embed Raw JavaScript"
 description: "Utility syntax to for raw JS usage in ReScript"
 canonical: "/docs/manual/v12.0.0/embed-raw-javascript"
+section: "JavaScript Interop"
+order: 2
 ---
 
 # Embed Raw JavaScript
diff --git a/docs/manual/equality-comparison.mdx b/docs/manual/equality-comparison.mdx
@@ -2,6 +2,8 @@
 title: "Equality and Comparison"
 description: "Handling equality and comparison checks"
 canonical: "/docs/manual/v12.0.0/equality-comparison"
+section: "Language Features"
+order: 28
 ---
 
 # Equality and Comparison
diff --git a/docs/manual/exception.mdx b/docs/manual/exception.mdx
@@ -2,6 +2,8 @@
 title: "Exception"
 description: "Exceptions and exception handling in ReScript"
 canonical: "/docs/manual/v12.0.0/exception"
+section: "Language Features"
+order: 19
 ---
 
 # Exception
diff --git a/docs/manual/extensible-variant.mdx b/docs/manual/extensible-variant.mdx
@@ -2,6 +2,8 @@
 title: "Extensible Variant"
 description: "Extensible Variants in ReScript"
 canonical: "/docs/manual/v12.0.0/extensible-variant"
+section: "Advanced Features"
+order: 1
 ---
 
 # Extensible Variant
diff --git a/docs/manual/external.mdx b/docs/manual/external.mdx
@@ -2,6 +2,8 @@
 title: "External (Bind to Any JS Library)"
 description: "The external keyword"
 canonical: "/docs/manual/v12.0.0/external"
+section: "JavaScript Interop"
+order: 3
 ---
 
 # External (Bind to Any JS Library)
diff --git a/docs/manual/function.mdx b/docs/manual/function.mdx
@@ -2,6 +2,8 @@
 title: "Function"
 description: "Function syntax in ReScript"
 canonical: "/docs/manual/v12.0.0/function"
+section: "Language Features"
+order: 13
 ---
 
 # Function
diff --git a/docs/manual/generalized-algebraic-data-types.mdx b/docs/manual/generalized-algebraic-data-types.mdx
@@ -2,6 +2,8 @@
 title: "Generalized Algebraic Data Types"
 description: "Generalized Algebraic Data Types in ReScript"
 canonical: "/docs/manual/v12.0.0/generalized-algebraic-data-types"
+section: "Advanced Features"
+order: 4
 ---
 
 # Generalized Algebraic Data Types
diff --git a/docs/manual/generate-converters-accessors.mdx b/docs/manual/generate-converters-accessors.mdx
@@ -2,6 +2,8 @@
 title: "Generate Converters & Helpers"
 description: "All about the @deriving decorator, and how to generate code from types"
 canonical: "/docs/manual/v12.0.0/generate-converters-accessors"
+section: "JavaScript Interop"
+order: 12
 ---
 
 # Generate Converters & Helpers
diff --git a/docs/manual/import-export.mdx b/docs/manual/import-export.mdx
@@ -2,6 +2,8 @@
 title: "Import & Export"
 description: "Importing / exporting in ReScript modules"
 canonical: "/docs/manual/v12.0.0/import-export"
+section: "Language Features"
+order: 25
 ---
 
 # Import & Export
diff --git a/docs/manual/import-from-export-to-js.mdx b/docs/manual/import-from-export-to-js.mdx
@@ -2,6 +2,8 @@
 title: "Import from / Export to JS"
 description: "Importing / exporting JS module content in ReScript"
 canonical: "/docs/manual/v12.0.0/import-from-export-to-js"
+section: "JavaScript Interop"
+order: 7
 ---
 
 # Import from/Export to JS
diff --git a/docs/manual/inlining-constants.mdx b/docs/manual/inlining-constants.mdx
@@ -2,6 +2,8 @@
 title: "Inlining Constants"
 description: "Inlining constants"
 canonical: "/docs/manual/v12.0.0/inlining-constants"
+section: "JavaScript Interop"
+order: 10
 ---
 
 # Inlining Constants
diff --git a/docs/manual/installation.mdx b/docs/manual/installation.mdx
@@ -2,6 +2,8 @@
 title: "Installation"
 description: "ReScript installation and setup instructions"
 canonical: "/docs/manual/v12.0.0/installation"
+section: "Overview"
+order: 2
 ---
 
 # Installation
diff --git a/docs/manual/interop-cheatsheet.mdx b/docs/manual/interop-cheatsheet.mdx
@@ -2,6 +2,8 @@
 title: "Interop Cheatsheet"
 description: "Cheatsheet for various interop scenarios in ReScript"
 canonical: "/docs/manual/v12.0.0/interop-cheatsheet"
+section: "JavaScript Interop"
+order: 1
 ---
 
 # Interop Cheatsheet
diff --git a/docs/manual/interop-with-js-build-systems.mdx b/docs/manual/interop-with-js-build-systems.mdx
@@ -2,6 +2,8 @@
 title: "Interop with JS Build Systems"
 description: "Documentation on how to interact with existing JS build systems"
 canonical: "/docs/manual/v12.0.0/interop-with-js-build-systems"
+section: "Build System"
+order: 6
 ---
 
 # Interop with JS Build Systems
diff --git a/docs/manual/introduction.mdx b/docs/manual/introduction.mdx
@@ -1,8 +1,8 @@
 ---
 title: "Introduction"
 description: "Introduction to the ReScript programming language"
-category: "manual"
-section: "overview"
+canonical: "/docs/manual/v12.0.0/introduction"
+section: "Overview"
 order: 1
 ---
 
diff --git a/docs/manual/json.mdx b/docs/manual/json.mdx
@@ -2,6 +2,8 @@
 title: "JSON"
 description: "Interacting with JSON in ReScript"
 canonical: "/docs/manual/v12.0.0/json"
+section: "JavaScript Interop"
+order: 9
 ---
 
 # JSON
diff --git a/docs/manual/jsx.mdx b/docs/manual/jsx.mdx
@@ -2,6 +2,8 @@
 title: "JSX"
 description: "JSX syntax in ReScript and React"
 canonical: "/docs/manual/v12.0.0/jsx"
+section: "Language Features"
+order: 18
 ---
 
 # JSX
diff --git a/docs/manual/lazy-values.mdx b/docs/manual/lazy-values.mdx
@@ -2,6 +2,8 @@
 title: "Lazy Value"
 description: "Data type for deferred computation in ReScript"
 canonical: "/docs/manual/v12.0.0/lazy-values"
+section: "Language Features"
+order: 20
 ---
 
 # Lazy Value
diff --git a/docs/manual/let-binding.mdx b/docs/manual/let-binding.mdx
@@ -2,6 +2,8 @@
 title: "Let Binding"
 description: "Let binding syntax for binding to values in ReScript"
 canonical: "/docs/manual/v12.0.0/let-binding"
+section: "Language Features"
+order: 2
 ---
 
 # Let Binding
diff --git a/docs/manual/libraries.mdx b/docs/manual/libraries.mdx
@@ -2,6 +2,8 @@
 title: "Libraries & Publishing"
 description: "Install & publish ReScript packages"
 canonical: "/docs/manual/v12.0.0/libraries"
+section: "JavaScript Interop"
+order: 14
 ---
 
 # Libraries & Publishing
diff --git a/docs/manual/module-functions.mdx b/docs/manual/module-functions.mdx
@@ -2,6 +2,8 @@
 title: "Module Functions"
 description: "Module Functions in ReScript"
 canonical: "/docs/manual/v12.0.0/module-functions"
+section: "Advanced Features"
+order: 3
 ---
 
 # Module Functions
diff --git a/docs/manual/module.mdx b/docs/manual/module.mdx
@@ -2,6 +2,8 @@
 title: "Module"
 description: "ReScript modules, module signatures and interface files"
 canonical: "/docs/manual/v12.0.0/module"
+section: "Language Features"
+order: 24
 ---
 
 # Module
diff --git a/docs/manual/mutation.mdx b/docs/manual/mutation.mdx
@@ -2,6 +2,8 @@
 title: "Mutation"
 description: "Imperative and mutative programming capabilities in ReScript"
 canonical: "/docs/manual/v12.0.0/mutation"
+section: "Language Features"
+order: 17
 ---
 
 # Mutation
diff --git a/docs/manual/null-undefined-option.mdx b/docs/manual/null-undefined-option.mdx
@@ -2,6 +2,8 @@
 title: "Null, Undefined and Option"
 description: "JS interop with nullable and optional values in ReScript"
 canonical: "/docs/manual/v12.0.0/null-undefined-option"
+section: "Language Features"
+order: 11
 ---
 
 # Null, Undefined and Option
diff --git a/docs/manual/object.mdx b/docs/manual/object.mdx
@@ -2,6 +2,8 @@
 title: "Object"
 description: "Interoping with JS objects in ReScript"
 canonical: "/docs/manual/v12.0.0/object"
+section: "Language Features"
+order: 7
 ---
 
 # Object
diff --git a/docs/manual/overview.mdx b/docs/manual/overview.mdx
@@ -3,6 +3,8 @@ title: "Overview"
 metaTitle: "Language Features Overview"
 description: "A quick overview on ReScript's syntax"
 canonical: "/docs/manual/v12.0.0/overview"
+section: "Language Features"
+order: 1
 ---
 
 # Overview
diff --git a/docs/manual/pattern-matching-destructuring.mdx b/docs/manual/pattern-matching-destructuring.mdx
diff --git a/docs/manual/pipe.mdx b/docs/manual/pipe.mdx
diff --git a/docs/manual/polymorphic-variant.mdx b/docs/manual/polymorphic-variant.mdx
diff --git a/docs/manual/primitive-types.mdx b/docs/manual/primitive-types.mdx
diff --git a/docs/manual/project-structure.mdx b/docs/manual/project-structure.mdx
diff --git a/docs/manual/promise.mdx b/docs/manual/promise.mdx
diff --git a/docs/manual/record.mdx b/docs/manual/record.mdx
diff --git a/docs/manual/reserved-keywords.mdx b/docs/manual/reserved-keywords.mdx
diff --git a/docs/manual/scoped-polymorphic-types.mdx b/docs/manual/scoped-polymorphic-types.mdx
diff --git a/docs/manual/shared-data-types.mdx b/docs/manual/shared-data-types.mdx
diff --git a/docs/manual/tagged-templates.mdx b/docs/manual/tagged-templates.mdx
diff --git a/docs/manual/tuple.mdx b/docs/manual/tuple.mdx
diff --git a/docs/manual/type.mdx b/docs/manual/type.mdx
diff --git a/docs/manual/typescript-integration.mdx b/docs/manual/typescript-integration.mdx
diff --git a/docs/manual/use-illegal-identifier-names.mdx b/docs/manual/use-illegal-identifier-names.mdx
diff --git a/docs/manual/variant.mdx b/docs/manual/variant.mdx
diff --git a/docs/manual/warning-numbers.mdx b/docs/manual/warning-numbers.mdx
diff --git a/public/llms/manual/template.mdx b/public/llms/manual/template.mdx
