This repository (@lavanet/docs) contains technical documentation for the Lava ecosystem. The most recent version of this repository is deployed to the Lava docs website and is viewable there. If you're averse to rich formatting, Lava Documentation can also be browsed as plain source in the markdown files available in the docs folder of this repository. The Lava docs website is built using Docusaurus 2, a modern static website generator, and deployed using the Netlify Web Platform.
Contents include:
- Information on Lava's supported chains
- Installation & Setup Guides for Validators, Providers, and Developers
- Network & Protocol Details on Lava's Unique Features
- Links to in-demand RPC & Web3 APIs
Contributing to the documentation of Lava is a rewarding way to give back to the ecosystem. We always welcome contributors with love & kindness. After reviewing this README, please read the contribution guide to help you get started.
The main branch of this repository is automatically deployed to our docs site, and other branches and pull requests leverage Netlify deploy. Please note that unless you are a recognized contributor of this repository, each attempted PR generates a Netlify approval that will prevent your pull request from being merged. Once the request is approved and a Netlify deploy preview is generated, a Netlify deploy preview will appear in the body of your PR as 😎 Deploy Preview. This deploy preview will be audited by a docs maintainer before merging your pull request.
We recommend naming your fork lava-docs to distinguish from other projects which might have similar naming conventions.
SSH (recommended)
git clone [email protected]:Your-User-Name-Here/lava-docs.gitHTTPS
git clone https://github.com/Your-User-Name-Here/lava-docs.gitcd lava-docs/
cp .env.example .envChange the contents of your environmental variables(.env) file to the following:
ALGOLIA_APP_ID=demo
ALGOLIA_API_KEY=demo
ALGOLIA_INDEX_NAME=demo
Algolia search needs values assigned to these in order to start. For local docs instances (w/ non-functional search), any dummy values will work.
yarn install
yarn start
Your preview will dynamically change/hotload as you make changes to files.
yarn build
Your build will appear in the ./build/ folder of your docs directory.
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.
$ GIT_USER=<Your GitHub username> yarn deploy