Contributing¶
We welcome anyone interested in contributing to this project, be it with new ideas, suggestions, by filing bug reports or contributing code.
You are invited to submit pull requests / issues to our Github repository.
Contributing examples¶
Nice examples are always welcome.
You can even submit your Jupyter notebook (.ipynb
) directly
as an example.
For contributing notebooks (and working with notebooks in git
in general) we have compiled a workflow for you which we suggest
you follow:
Locally install this precommit hook for git
This obviously has to be done only once. The hook checks if any of the notebooks you are including in a commit contain a non-empty output cells.
Then for every notebook:
Write the notebook (let’s call it
foo.ipynb
) and place it inexamples/foo.ipynb
.Ask yourself: Is the output in each of the notebook’s cells relevant for to example?
Yes: Leave it there. Just make sure to keep the amount of pictures/… to a minimum.
No: Clear the output of all cells, e.g. Edit -> Clear all output in JupyterLab.
Provide a link to the documentation: Include a file
foo.nblink
located indoc/examples/foo.nblink
with this contentLink your file in the documentation:
Either
Include your
examples/foo.nblink
directly into one of the documentations toctrees; orTell us where in the documentation you want your example to show up
Commit your changes. If the precommit hook you installed above kicks in, confirm your decision (‘y’) or go back (‘n’) and delete the output of the notebook’s cells.
Create a pull request for us to accept your example.
For the reasoning and details behind this workflow, see atlite/issues#38.
The support for the the .ipynb
notebook format in our documentation
is realised via the extensions nbsphinx and nbsphinx_link.
Authors, Contributions and Copyright¶
Major contributions until now from:
Contributions |
Contributor |
Affiliation |
---|---|---|
2016-2020 |
Jonas Hörsch |
|
2019-2021 |
Fabian Hofmann |
FIAS Frankfurt |
2019-2020 |
Johannes Hampp |
University Giessen |
2016-2019 |
Tom Brown |
|
2016-2017 |
Gorm Andresen |
Aarhus University |
2016-2017 |
David Schlachtberger |
FIAS Frankfurt |
2016-2017 |
Markus Schlott |
FIAS Frankfurt |