Developer documentation workflow

What you need to know

For developer documentation, we use Doxygen comments extensively throughout NEST.

After installing NEST, you can extract comments from the source code with make docs. A doxygen folder with HTML files will be generated in the doc folder in your source directory.


This workflow shows you how to create developer documentation for NEST. For the user documentation, please refer to our User documentation workflow.


  1. Install Doxygen and graphviz.

    If you are a Linux user, type:

    sudo apt install doxygen graphviz

    For macOS, please use Homebrew:

    brew install doxygen graphviz
  2. Navigate to, or create a build directory. See Install NEST.

  3. Add the -Dwith-devdoc=ON flag to your regular CMake command:

    cmake -Dwith-devdoc=ON
  1. Generate HTML:

    make docs
  2. Preview documentation:

    cd doc/doxygen/html
    browser index.html