2024-08-04 03:25:13 +00:00
# Monero Docs
2021-11-14 23:17:16 +00:00
2024-08-04 03:25:13 +00:00
This repository contains the source files to Monero Community documentation hosted at [docs.getmonero.org ](https://docs.getmonero.org )
2021-11-14 23:17:16 +00:00
2024-08-04 03:25:13 +00:00
- [About ](#about )
- [Contributing ](#contributing )
- [Build ](#build )
- [License ](#license )
2021-11-14 23:17:16 +00:00
2024-08-04 03:25:13 +00:00
## About
2021-11-14 23:17:16 +00:00
2024-08-04 03:25:13 +00:00
Monero Docs intends to be a Knowledge Base and User Guide for interacting with Monero.
2021-11-14 23:17:16 +00:00
## Contributing
2024-08-04 03:25:13 +00:00
Contributions are both encouraged and greatly appreciated.
2021-11-14 23:17:16 +00:00
2024-08-04 03:25:13 +00:00
To contribute content, fork this repo and make a pull request to the test branch including your changes.
2021-11-14 23:17:16 +00:00
2024-08-04 03:25:13 +00:00
1. On GitHub, fork the [monero-docs ](https://github.com/monero-project/moneo-docs ) repo
2. Clone your newly created repo. (Note: replace `your-username` with your GitHub username)
2021-11-14 23:17:16 +00:00
2024-08-04 03:25:13 +00:00
via ssh:
```bash
git clone git@github.com:your-username/monero-docs
```
via https:
```bash
git clone https://github.com/your-username/monero-docs
```
3. Navigate to the repo and create a new topic branch
```bash
cd monero-docs
git checkout -b foobar
```
4. After making modifications, commit and push your changes to your topic branch
5. Open a PR against the monero-docs `master` branch
2021-11-14 23:17:16 +00:00
# Run the documentation server locally
2024-08-04 03:25:13 +00:00
- The build process for mkdocs utilizes Python
- It is recommended to install python pip dependencies inside of a Virtual Environment [(venv) ](https://squidfunk.github.io/mkdocs-material/guides/creating-a-reproduction/#environment )
Note: You may need to first install `python3-venv` or the equivalent for your distribution
1. Navigate to your `monero-docs` repo
2. Create the python virtual environment
```bash
mkdir .monero-docs-venv
python3 -m venv .monero-docs-venv
. .monero-docs-venv/bin/activate
```
3. Install mkdocs dependencies to the venv
```bash
pip install -r requirements.txt
```
4. Run the documentation server locally
```bash
2021-11-14 23:17:16 +00:00
python3 -m mkdocs serve
```
2024-08-04 03:25:13 +00:00
5. View your changes at [http://localhost:8000 ](http://localhost:8000 )
## License
The documentation is provided under the [MIT License ](LICENSE ).