/avalanche-docs

Primary LanguageJavaScriptBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Avalanche Docs


Español

Overview

This repository contains the contents for the Avalanche Developer Documentations deployed at https://docs.avax.network.

The site is built using Docusaurus 2.

Contributing

Contributing to the docs site is a great way to get involved with the Avalanche dev community! Here's how to get started:

Quick Fixes

For small typos or corrections, it is easy to contribute without the need to clone/fork the repository. Simply:

  • Scroll to the bottom of the page and hit "Edit this page"
  • Make changes to the page directly in Github's GUI
  • Hit "Commit changes ..."
  • Edit the commit message to describe the change in 4 or less words, and include any extra details in the description
  • Hit "Sign off and commit changes" to raise a PR with your proposed changes

New Content or Extensive Changes

To propose new docs or large edits to our existing pages, follow the steps accordingly:

  • Ava Labs Github Organization Members: Clone the repo git clone https://github.com/ava-labs/avalanche-docs.git
  • External Contributors: Fork the repo via GitHub's GUI
  • Checkout to a new branch git checkout -b <your-name/branch-name>
  • Make changes on your branch
  • git add .
  • yarn build to ensure the build passes
  • git commit -m "some commit message"
  • git push
  • Head to GitHub and open a new pull request

Structure and Syntax

Pull Request (PR)

  • 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.

Installation

yarn

Local Development

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.

Build

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.

Search

Search is powered by Algolia and the config file is located here.

New or Missing Content Requests

The information I am requesting is related to a specific project, i.e. AvalancheGo, AvalancheNetworkRunner, etc.:

  • Please raise a Missing Docs Issue in the GitHub repository of that project and thoroughly detail your request. Include references to any existing pages relevant to your request.

The information I am requesting is explanatory in nature and does not currently exist:

  • Please open a new Issue in this repository and thoroughly detail your request according to the issue template. If urgent, please create a new ticket in the Dev Docs Improvement Proposals dashboard.

Erroneous or missing information on documentation unrelated to a specific project needs editing:

  • If you understand the issue enough to provide a correction, follow the steps here.
  • If not, please raise an Issue.