Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This is a attempt to setup a skeleton notebook workflow.
The suggested workflow (heavily borrowed from wradlib) executes the notebooks in a headless state using Travis-CI and creates a sphinx-doc from them.
The notebooks need to be in a clean state without output. I manually pushed the created docs to the gh-pages branch, they are available here: http://openradarscience.org/openradar-cookbooks. If merged, the docs will be build automatically and pushed to the gh-pages branch.
The notebooks will be placed under the notebook-folder inside the repo. We can have different subfolders, corresponding to different aspects (wradlib, pyart, erad, ams etc.). One thing we need to do manually is reflecting the notebooks structure inside the doc/source as seen with the skeleton. Incorporation of the data will be done with the openradar-data repo (not yet functional).
Travis-CI is momentarily using latest miniconda but we can think about other means (vagrant/docker) to get all dependencies in one (eg. for baltrad).
The workflow will then be:
Within Travis-CI python 2.7, 3.5 and 3.6 are tested. The docs are build atm on 2.7.