📚 ReHLDS Documentation

This repository contains the documentation for the ReHLDS project, built using Docusaurus.

Prerequisites

• Node.js version 22 LTS
• NPM (comes with Node.js)
• Install yarn (or pnpm, bun, etc. or use npm)

Getting Started

1. Clone the repository

2. node -v Should print v22.17.1 or other 22.x

3. corepack enable yarn

4. yarn -v

5. Install the dependencies

    yarn install --frozen-lockfile

1. Start the local development server

    yarn start

This will launch the documentation at http://localhost:3000 with hot reloading enabled. Any changes made to the content will automatically refresh the browser.

Available Scripts

• docusaurus: Runs the Docusaurus CLI.
• start: Starts the development server.
• build: Builds the static website for production.
• swizzle: Customizes the Docusaurus theme.
• deploy: Deploys the website (requires configuration).
• clear: Cleans up the cached data and files.
• serve: Serves the production build locally.
• write-translations: Prepares translation files.
• write-heading-ids: Generates heading IDs for markdown.
• typecheck: Runs TypeScript type checking.

Building for Production

To create a production build of the documentation:

    yarn run build

The output will be in the build directory, which can be served by any static site hosting service.

Deployment

To deploy the documentation site, make sure to configure the deployment settings in docusaurus.config.js and run:

    yarn run deploy

Type Checking

To check for TypeScript errors, run:

    yarn run typecheck

This will ensure that all TypeScript code adheres to type definitions.

Browser Support

This project follows the browserslist specification to support modern browsers in production and the last few versions of major browsers in development.

Contributing

Feel free to contribute to the documentation by submitting pull requests. Please follow the contribution guidelines and ensure that your changes pass all checks before submitting.