Skip to content

Sphinx extensions for workflow documentation#1155

Merged
sphuber merged 16 commits into
aiidateam:workflowsfrom
greschd:workflows_sphinxext
Feb 20, 2018
Merged

Sphinx extensions for workflow documentation#1155
sphuber merged 16 commits into
aiidateam:workflowsfrom
greschd:workflows_sphinxext

Conversation

@greschd
Copy link
Copy Markdown
Member

@greschd greschd commented Feb 20, 2018

Supersedes #748, fixes #721.

Defines a sphinx directive aiida-workchain, which produces documentation like this:

screenshot from 2018-02-20 11-03-54

The command is also hooked into sphinx.ext.autodoc, meaning that workchain classes documented with autodoc will be shown in this way when the aiida.sphinxext module is used. The inputs which are not stored in the DB can be hidden with the :hide-nondb-inputs: flag.

The tests are run separately form the main AiiDA tests.

@greschd greschd requested a review from sphuber February 20, 2018 10:06
@greschd greschd changed the title Workflows sphinxext Sphinx extensions for workflow documentation Feb 20, 2018
@sphuber sphuber merged commit f5b4d0b into aiidateam:workflows Feb 20, 2018
@greschd greschd deleted the workflows_sphinxext branch April 11, 2018 15:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants