Skip to content

feat: split out docs/guidelines routes from shared MdxRoute file#1224

Merged
jderochervlk merged 2 commits intomasterfrom
vlk/split-out-docs-guidelines
Apr 10, 2026
Merged

feat: split out docs/guidelines routes from shared MdxRoute file#1224
jderochervlk merged 2 commits intomasterfrom
vlk/split-out-docs-guidelines

Conversation

@jderochervlk
Copy link
Copy Markdown
Collaborator

@jderochervlk jderochervlk commented Apr 3, 2026

This pull request adds support for a new "docs/guidelines" section to the documentation site. It introduces a dedicated route and loader for guideline pages, ensures proper routing and filtering, and updates the layout to match other documentation sections.

Routing and page loading:

  • Added a new route handler DocsGuidelinesRoute with a corresponding loader to render markdown files from markdown-pages/docs/guidelines, extract metadata, build a table of contents, and set up the page layout. (app/routes/DocsGuidelinesRoute.res, app/routes/DocsGuidelinesRoute.resi) [1] [2]
  • Updated the main routes configuration to scan and include all guideline markdown files as routes, similar to how manual and react docs are handled. (app/routes.res) [1] [2]

Routing logic and filtering:

  • Modified the MDX routes filter to exclude "docs/guidelines" paths from generic MDX handling, ensuring they are handled by the new dedicated route. (app/routes.res)
  • Updated the fallback logic in MdxRoute to properly handle "docs/guidelines" paths, so they render with the correct layout when matched. (app/routes/MdxRoute.res)

Note

This work was done with AI assistance

@jderochervlk jderochervlk force-pushed the vlk/split-out-docs-guidelines branch from 7a704d4 to d2cba9f Compare April 9, 2026 13:29
@jderochervlk jderochervlk changed the base branch from vlk/split-out-docs-react to master April 9, 2026 13:29
@jderochervlk jderochervlk marked this pull request as ready for review April 9, 2026 13:29
@github-actions
Copy link
Copy Markdown

Cloudflare deployment

Deployement ID: 871f3aad-713b-448d-9f33-e631d304a022
Deployment Environment: preview

⛅️ wrangler 4.63.0 (update available 4.81.1)
─────────────────────────────────────────────
✨ Compiled Worker successfully
Uploading... (7190/7663)
Uploading... (7348/7663)
Uploading... (7505/7663)
Uploading... (7663/7663)
✨ Success! Uploaded 473 files (7190 already uploaded) (4.78 sec)

✨ Uploading _redirects
✨ Uploading Functions bundle
🌎 Deploying...
✨ Deployment complete! Take a peek over at https://871f3aad.rescript-lang.pages.dev
✨ Deployment alias URL: https://vlk-split-out-docs-guideline.rescript-lang.pages.dev

@jderochervlk jderochervlk merged commit 00a9390 into master Apr 10, 2026
6 checks passed
@jderochervlk jderochervlk deleted the vlk/split-out-docs-guidelines branch April 10, 2026 13:54
Copilot AI added a commit that referenced this pull request Apr 10, 2026
Keep both docsManualRoutes (from this branch) and docsGuidelinesRoutes
(added in master via #1224). Update mdxRoutes filter to exclude both
docs/manual and docs/guidelines paths.

Co-authored-by: jderochervlk <60623931+jderochervlk@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants