This repository contains the source files to Monero Community documentation hosted at docs.getmonero.org
Monero Docs intends to be a Knowledge Base and User Guide for interacting with Monero.
Contributions are both encouraged and greatly appreciated.
To contribute content, fork this repo and make a pull request to the master
branch including your changes.
- On GitHub, fork the monero-docs repo
- Clone your newly created repo. (Note: replace
your-username
with your GitHub username)
via ssh:
git clone git@github.com:your-username/monero-docs
via https:
git clone https://github.com/your-username/monero-docs
- Navigate to the repo and create a new topic branch
cd monero-docs
git checkout -b foobar
- After making modifications, commit and push your changes to your topic branch
- Open a PR against the monero-docs
master
branch
- The build process for mkdocs utilizes Python
- It is recommended to install python pip dependencies inside of a Virtual Environment (venv)
Note: You may need to first install python3-venv
or the equivalent for your distribution
- Navigate to your
monero-docs
repo - Create the python virtual environment
python3 -m venv .monero-docs-venv
. .monero-docs-venv/bin/activate
- Install mkdocs dependencies to the venv
pip install -r requirements.txt
- Run the documentation server locally
python3 -m mkdocs serve
- View your changes at http://localhost:8000
The documentation is provided under the MIT License.