PeeringDB Documentation

NOTE Please do not put issues here anymore, new issues should be created at https://github.com/peeringdb/peeringdb/issues

To work on and change these documents, you'll need git, python, and pip.

Fork the repo

Clone the repo

git clone git@github.com:$GITHUB_USERNAME/docs.git
cd docs

Install MkDocs and other requirements

pip install -r facsimile/requirements-docs.txt

Start mkdocs

mkdocs serve

or, if you'd like to specify the port, use -a $ADDRESS:$PORT, for example:

mkdocs serve -a 0.0.0.0:7889

You should now see a message similar to: Serving on http://127.0.0.1:8000

Point your browser at that URL, and you'll get real time updates to the generated documentation as you edit.

Markdown has its own formatting syntax, to get started look here for an excellent cheatsheet.

Once you are happy with your changes, commit and push, then run

git commit -a
git push

If you want to be able to view your changes at $GITHUB_USER.github.io/docs, just run:

mkdocs gh-deploy

To get your changes pushed to the live site, just create a pull request, if you're unfamiliar with how to do that, GitHub has documentation.

The first time you want to do it, you need to add a remote with

git remote add upstream git@github.com:peeringdb/docs.git

After that, to sync to the upstream repo and verify requirements

git fetch upstream
git merge upstream/master
pip install -r facsimile/requirements-docs.txt

gaes212/docs