Documenting a plugin

If you used the AiiDA plugin cutter, your plugin already comes with a basic documentation that just needs to be adjusted to your needs.

  1. Install the docs extra:

    pip install -e .[docs]
  2. Populate, delete, or add to the individual documentation pages:

  3. Use Sphinx to generate the html documentation:

    cd docs

    Check the result by opening build/html/index.html in your browser.

  4. Host your documentation online on ReadTheDocs. Simply sign up and import your project. Make sure to add the path to the requirements file docs/requirements_for_rtd.txt and the Python configuration file docs/source/ in Admin => Advanced settings.

Note: When updating the plugin to a new version, remember to update the version number both in setup.json and aiida_mycode/