Skip to content

KinsonDigital/VelaptorDocs

📃 Velaptor Documentation Website 📃

Build PR Status Check Website Status

Hello!! This repository is for the documentation website for Velaptor and contains Velaptor tutorials and API documentation.

How to Contribute

This website is built using Docusaurus 3, a modern static website generator. Please refer to the original Docusaurus Documentation to learn about how it works and how to get started.

Below are simple steps you will need when contributing.

  1. Fork the repository
  2. Create a feature branch with the syntax feature/<issue-number>-<branch-description>.

    Note

    • Example: feature/123-my-branch
    • Feature branches are created from main and are merged back into main.
  3. Every issue has a pull request. Make sure that it is ok to work on the issue by contacting a maintainer.

    Note You can contact a maintainer in the comments of the issue and in Discord. Leaving a comment in the issue is a must so the maintainer can assign the issue to you.

  4. Create pull request.

    Note Please use Early Pull Requests

    • The first commit should be an empty commit with the message of Start work for issue #<issue-number>.
    • Please create the pull request in draft. 😀
  5. Perform your work. Make sure to test locally!!
  6. Take the PR out of draft which will request a review.

    Note Let a maintainer know that it is ready for review!

Common Development Commands

Install npm packages

Use the command pnpm i or pnpm install to install all of the project's dependencies.

Local Development Server

Use the command pnpm start to starts a local development server. Most changes are reflected HMR(Hot Module Replacement) without having to restart the server.

Build

Use the command pnpm build to produce a production build of the site. This command puts the production build into the build directory and can be served using any static content hosting service.

Serve Build Locally

Use the command pnpm serve to run a local server of the production version of the website.