Documentation details

The PowerDNS documentation started life as SGML DocBook, and was later converted (with great pain) to XML DocBook. Late 2014, Pieter Lexis contributed a Markdown conversion, which is the basis of the current documentation.

If you note an issue with the new documentation, please open a ticket on GitHub and tell us about it. Or, even better, fork our repo, and edit the files in docs/markdown to improve things.

If your change is simple (say, a typo or a new paragraph), you can do all this entirely from GitHub. Simply fork PowerDNS, find the Markdown file you want to change, edit in place, commit, and create a pull request.

Building and testing

It's recommended to use a virtualenv with the required packages to build the documentation. Virtualenvwrapper can be used to easily create and use a virtualenv.

Once you're in a virtualenv, pip install mkdocs==0.11.1 pandocfilters==1.2.3.

To test-build the documentation, make html/index.html in the docs directory will build the documentation into html/.

To test your changes live, use mkdocs serve --dev-addr=0.0.0.0:8000, and the new version of your documentation will appear on port 8000 of your machine.