Welcome to the documentation website for the Casper Network. The documentation lives at this address: https://docs.casper.network/.
Read this page to learn how to contribute new content and run the documentation website locally.
Follow these steps to run the documentation website locally, displayed in your localhost at http://localhost:3000/.
-
Install a code editor, such as Visual Studio Code (
vscode
). You may also want to install editing extensions such asprettier
,eslint
, and others listed in the.vscode/extensions.json
file. -
Install Node.js (version 16.14+).
-
Install
yarn
vianpm
using this command:npm install --global yarn
-
Create a fork of the documentation repository in GitHub: https://github.com/casper-network/docs/.
-
Clone the fork on your machine.
git clone https://github.com/USERNAME/docs
-
In the forked folder, run this command, which is required to run only once for a folder:
yarn install
-
Start the localhost server:
yarn run start
-
Access http://localhost:3000/ in your browser.
The following section details how to update the content.
- Navigate to the
source/docs/casper
folder. - Find the content you want to update and modify the markdown file(s). If you want to add new content, read the Developer Guide and the Writing Style Guide.
- Run the website locally to test your changes.
- Submit changes to the documentation using a pull request from your forked repository.
Note: The website refreshes as you change the markdown files. However, if you change the structure or configuration of the website, you need to restart the application.
Adding new content may require structural changes. Read the Developer Guide and the Writing Style Guide.