Contributing
This project follows the all contributors specification. Contributions in many different ways are welcome!
Contribution Types
Report Bugs
Report bugs at https://github.com/NCCR-SYNAPSY/neurodatapub/issues.
If you are reporting a bug, please include:
Your operating system name and version.
Any details about your local setup that might be helpful in troubleshooting.
Detailed steps to reproduce the bug.
Fix Bugs
Look through the GitHub issues for bugs. Anything tagged with “bug” and “help wanted” is open to whoever wants to implement it.
Implement Features
Look through the GitHub issues for features. Anything tagged with “enhancement” and “help wanted” is open to whoever wants to implement it.
Write Documentation
NeuroDataPub could always use more documentation, whether as part of the official NeuroDataPub docs, in docstrings, or even on the web in blog posts, articles, and such.
Submit Feedback
The best way to send feedback is to create an issue at https://github.com/NCCR-SYNAPSY/neurodatapub/issues.
If you are proposing a feature:
Explain in detail how it would work.
Keep the scope as narrow as possible, to make it easier to implement.
Remember that this is a volunteer-driven project, and that contributions are welcome :)
Get Started!
Ready to contribute? Here’s how to set up NeuroDataPub
for local development.
Fork the
neurodatapub
repo on GitHub.Clone your fork locally:
git clone git@github.com:your_name_here/neurodatapub.git cd neurodatapub
Create a branch for local development:
git checkout -b name-of-your-bugfix-or-feature
Now you can make your changes locally.
Note
Please keep your commit the most specific to a change it describes. It is highly advice to track unstaged files with git status
, add a file involved in the change to the stage one by one with git add <file>
. The use of git add .
is highly discouraged. When all the files for a given change are staged, commit the files with a brief message using git commit -m "[COMMIT_TYPE]: Your detailed description of the change."
that describes your change and where [COMMIT_TYPE]
can be [FIX]
for a bug fix, [ENH]
for a new feature, [MAINT]
for code maintenance and typo fix, [DOC]
for documentation, [CI]
for continuous integration testing.
When you’re done making changes, push your branch to GitHub:
git push origin name-of-your-bugfix-or-feature
Submit a pull request through the GitHub website.
Pull Request Guidelines
Before you submit a pull request, check that it meets these guidelines:
If the pull request adds functionality, the docs should be updated (See documentation build instructions).
The pull request should work for Python 3.8. Check https://app.circleci.com/pipelines/github/NCCR-SYNAPSY/neurodatapub and make sure that the tests pass.
How to install NeuroDataPub
locally
Install the
NeuroDataPub
conda environmentneurodatapub-env
that provides a Python 3.8 environment:cd neurodatapub conda env create -f conda/environment.yml
Activate the
neurodatapub-env
conda environment and installneurodatapub
conda activate neurodatapub-env pip install .
How to build the documentation locally
Install the
NeuroDataPub
conda environmentneurodatapub-env
with sphinx and all extensions to generate the documentation:cd neurodatapub conda env create -f conda/environment.yml
Activate the conda environment
neurodatapub-env
and installneurodatapub
conda activate neurodatapub-env pip install .
Run the script
build_sphinx_docs.sh
to generate the HTML documentation indocumentation/_build/html
:bash build_sphinx_docs.sh
Note
Make sure to have activated the conda environment neurodatapub-env
before running the script build_sphinx_docs.sh
.
Not listed as a contributor?
This is easy, NeuroDataPub
has the all contributors bot installed.
Just comment on Issue or Pull Request (PR), asking @all-contributors
to add you as contributor:
@all-contributors please add <github_username> for <contributions>
<contribution>
: See the Emoji Key Contribution Types Reference for a list of valid contribution
types.
The all-contributors bot will create a PR to add you in the README and reply with the pull request details.
When the PR is merged you will have to make an extra Pull Request where you have to:
add your entry in the
zenodo.json
(for that you will need an ORCID ID - https://orcid.org/). Doing so, you will appear as a contributor on Zenodo in the future version releases of NeuroDataPub. Zenodo is used by NeuroDataPub to publish and archive each of the version release with a unique Digital Object Identifier (DOI), which can then be used for citation.update the content of the table in
docs/contributors.rst
with the new content generated by the bot in the README. Doing so, you will appear in the Contributors Page.
This document has been adapted from the MIALSRTK contributing guidelines and inspired by these great contributing guidelines.