Skip to content

Documentation website #11

Merged
brnrdog merged 11 commits intomainfrom
claude/rescript-docs-website-tMysI
Feb 11, 2026
Merged

Documentation website #11
brnrdog merged 11 commits intomainfrom
claude/rescript-docs-website-tMysI

Conversation

@brnrdog
Copy link
Owner

@brnrdog brnrdog commented Feb 11, 2026

No description provided.

@brnrdog brnrdog force-pushed the claude/rescript-docs-website-tMysI branch from 6876031 to 8527878 Compare February 11, 2026 01:07
Create a new documentation website using xote, basefn, and rescript-signals:

- Set up ReScript v12 project with Vite for building
- Configure for GitHub Pages deployment at brnrdog.github.io/rescript-signals
- Add sidebar navigation with API documentation and examples
- Create interactive examples (Counter, Todo List, Derived State)
- Include API reference pages for Signal, Computed, and Effect primitives
- Add syntax-highlighted code blocks using highlight.js
Add workflow to automatically build and deploy docs-website to GitHub Pages
when changes are pushed to main branch. Uses modern GitHub Pages deployment
with actions/deploy-pages.

Triggers on:
- Push to main branch (changes to docs-website/ or workflow file)
- Manual workflow dispatch
- Hide sidebar on homepage, show only on inner pages
- Add version number badge and GitHub icon to topbar
- Add Release Notes page that fetches and renders CHANGELOG.md
- Fix CodeBlock component to properly render syntax highlighted code
- Add global styles to fix layout gaps and improve spacing
- Improve overall styling consistency
Add a search component that allows users to search across all documentation
pages including API references, examples, and getting started guides. The
search displays results in a dropdown with category badges.
Add EditOnGitHub component that displays a link at the bottom of each
documentation page, allowing users to easily contribute improvements.
Add a copy button to all code blocks that copies the code to clipboard
and shows "Copied!" feedback for 2 seconds.
Sidebar navigation items now highlight based on the current URL path,
making it clear which page the user is currently viewing.
Add PageNavigation component that shows links to navigate between
documentation pages in sequence, making it easier to read through
the docs in order.
Add Breadcrumbs component that shows the navigation hierarchy at the
top of each documentation page, helping users understand their location
within the docs structure.
Add ScrollToTop component that appears when the user scrolls down
the page, allowing quick navigation back to the top of the document.
@brnrdog brnrdog force-pushed the claude/rescript-docs-website-tMysI branch from 8527878 to 0511ca7 Compare February 11, 2026 01:10
@brnrdog brnrdog marked this pull request as ready for review February 11, 2026 01:15
@brnrdog brnrdog merged commit 63e3ed5 into main Feb 11, 2026
2 checks passed
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.

1 participant