This repo contains the contents for our docs deployed here.
The website is built using Docusaurus 2.
Contributing to the docs site is a great way to get involved with the Avalanche dev community! Here's some things you need to know to get started.
- All the doc text are located in the docs directory; image files are put under static/img directory where a sub-dir is strongly recommended if there are multiple image files for a doc.
- The left sidebar of the page is controlled by sidebars.js.
- Extensive docs for Docusaurus can be found here.
- All PRs should be made against the
master
branch. - Following a successful build, Cloudflare Pages will comment on the PR with a link to *.avalanche-docs.pages.dev where you can verify your changes.
- Once your PR is merged into
master
, https://docs.avax.network/ will be updated with your changes.
yarn
yarn start
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
yarn build
This command generates static content into the build
directory and can be served using any static contents hosting service.
Please make sure that you run this command to see if there is any error in building the package, and fix them before pushing your changes.
We strongly recommend Visual Studio Code with Prettier whose configuration file can be found here.
Conventions:
- Title case is used in all section headers.
- All words
Subnet
should have first letter uppercased, except in the context of a command, path or logs.
Search is powered by Algolia and the config file is located here.