Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add documentation contribution instructions #6294

Merged
merged 6 commits into from
Jan 18, 2024
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -229,6 +229,25 @@ Run script to download dashboards to `./dashboards` folder
node scripts/download_dashboards.mjs
```

## Contributing to Documentation

When submitting PRs for documentation updates, build the docs locally and ensure functionality before submission. To build docs locally, ensure you have Python installed, then follow these steps:

```sh
pip install -r docs/requirements.txt
yarn build:docs
cd docs
mkdocs serve --watch pages
```
philknows marked this conversation as resolved.
Show resolved Hide resolved

Your locally served docs will then be accessible at http://localhost:8000.

If you run into build issues due to circular dependencies, branch switching or other incompatibilities, try cleaning your modules and rebuild your dependencies with:

```
philknows marked this conversation as resolved.
Show resolved Hide resolved
yarn clean && yarn clean:nm && yarn && yarn build
```

philknows marked this conversation as resolved.
Show resolved Hide resolved
## Label Guide

Issues and pull requests are subject to the following labeling guidelines.
Expand Down
Loading