Skip to content

Latest commit

 

History

History
78 lines (53 loc) · 2.24 KB

CONTRIBUTING.md

File metadata and controls

78 lines (53 loc) · 2.24 KB
Raw

Contributing

Please read in detail about how to contribute documentation and code on the Mermaid documentation site.

Mermaid contribution cheat-sheet

Requirements

  • volta to manage node versions.
  • Node.js. volta install node
  • pnpm package manager. volta install pnpm

Development Installation

If you don't have direct access to push to mermaid repositories, make a fork first. Then clone. Or clone directly from mermaid-js:

git clone [email protected]:mermaid-js/mermaid.git
cd mermaid

Install required packages:

# npx is required for first install as volta support for pnpm is not added yet.
npx pnpm install
pnpm test # run unit tests
pnpm dev # starts a dev server

Open http://localhost:9000 in your browser after starting the dev server. You can also duplicate the example.html file in demos/dev, rename it and add your own mermaid code to it. That will be served at http://localhost:9000/dev/your-file-name.html.

Docker

If you are using docker and docker-compose, you have self-documented run bash script, which is a convenient alias for docker-compose commands:

./run install # npx pnpm install
./run test # pnpm test

Testing

# Run unit test
pnpm test
# Run unit test in watch mode
pnpm test:watch
# Run E2E test
pnpm e2e
# Debug E2E tests
pnpm dev
pnpm cypress:open # in another terminal

Branch name format:

   [feature | bug | chore | docs]/[issue number]_[short description using dashes ('-') or underscores ('_') instead of spaces]

eg: feature/2945_state-diagram-new-arrow-florbs, bug/1123_fix_random_ugly_red_text

Documentation

Documentation is necessary for all non bugfix/refactoring changes.

Only make changes to files that are in /packages/mermaid/src/docs

DO NOT CHANGE FILES IN /docs MANUALLY

The /docs folder will be rebuilt and committed as part of a pre-commit hook.

Join our slack community if you want closer contact!