Contributing to these docs
We are using nuxt content + Docus to generate these docs.
All the config to generate the site lives in the docs folder, and the pages themself live in docs/content. To update any of these pages simple fork this repository, and update the files in the docs/content folder and submit a PR for approval to get your updates showing.
Quick Edits
To edit a file quickly you can just edit the markdown file on GitHub, it will prompt you to fork, commit and create a PR etc.
Large Edits
If you would like to make some major edits you can follow the below steps to preview your changes locally. This assumes you have some basic GH knowledge.
- Fork the repository
- Clone your fork locally
- Create a new branch
- Run the following commands to get it running locally
cd docs
npm i
npm run dev
- Click link to open
http://localhost:3000
- You can now run the docs locally. Make any changes you want to the markdown files, and as you save it will refresh to preview your new content.
- Add and Commit your changes, and push up to your fork.
- Create a PR from your feature branch to the main branch.
Icons
To add an icon to a folder, you can create a _dir.yml
file in the folder and find an icon from icones.js.org See existing folders for formating
Table of Contents