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
Once you're in a virtualenv,
pip install mkdocs==0.14 pandocfilters==1.2.3 click==5.1 LinkChecker==9.3.
To test-build the documentation,
make html/index.html in the docs
directory will build the documentation into
To test your changes live, use
cd docs/html && mkdocs serve && python -m SimpleHTTPServer,
and the new version of your documentation will appear on port 8000 of your machine.