You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
vitepress/.github/contributing.md

1.9 KiB

VitePress Contributing Guide

Hi! We're really excited that you are interested in contributing to VitePress. Before submitting your contribution, please make sure to take a moment and read through the following guidelines:

Pull Request Guidelines

  • Checkout a topic branch from the relevant branch, e.g. main, and merge back against that branch.

  • If adding a new feature:

    • Provide a convincing reason to add this feature. Ideally, you should open a suggestion issue first and have it approved before working on it.
  • If fixing bug:

    • Provide a detailed description of the bug in the PR. Live demo preferred.
  • It's OK to have multiple small commits as you work on the PR - GitHub can automatically squash them before merging.

  • Commit messages must follow the commit message convention so that changelogs can be automatically generated.

Development Setup

You will need pnpm

After cloning the repo, run:

# install the dependencies of the project
$ pnpm install

Setup VitePress Dev Environment

At first, execute the pnpm run build command.

$ pnpm run build

You only need to do this once for your fresh project. It copies required files and makes sure everything is in place. After this, you only need to run dev related commands.

The easiest way to start testing out VitePress is to tweak the VitePress docs. You may run pnpm run docs to boot up VitePress documentation site locally, with live reloading of the source code.

$ pnpm run docs

After executing the above command, visit http://localhost:5173 and try modifying the source code. You'll get live update.

If you don't need docs site up and running, you may start VitePress local dev environment with pnpm run dev.

$ pnpm run dev