🐣 We’re so excited you’re here and want to contribute. 🐣
The point of this starter kit is to welcome new users and contributors to the BIDS community. We hope that these guidelines are designed to make it as easy as possible to get involved. If you have any questions that aren’t discussed below, please let us know through one of the many ways to get in touch.
Joining the community¶
BIDS - the Brain Imaging Data Structure - is a growing community of neuroimaging enthusiasts, and we want to make our resources accessible to and engaging for as many researchers as possible.
We therefore require that all contributions adhere to our Code of Conduct.
How do you know that you’re a member of the BIDS community? You’re here! You know that BIDS exists! You’re officially a member of the community. It’s THAT easy! Welcome! 🙌 😂
Contributing through GitHub¶
We know that it can be daunting to start using git and GitHub if you haven’t worked with them in the past, but the BIDS Starter Kit maintainers are here to help you figure out any of the jargon or confusing instructions you encounter! 💕
In order to contribute via GitHub you’ll need to set up a free account and sign in. Here are some instructions to help you get going. Remember that you can ask us any questions you need to along the way.
The list of labels for current issues can be found here and includes:
If you feel that you can contribute to one of these issues, we especially encourage you to do so!
There are lots of ways to ask questions but opening an issue is a great way to start a conversation and get your answer.
If you’re not sure about how to go about contributing, these are good places to start. You’ll be mentored through the process by the maintainers team. If you’re a seasoned contributor, please select a different issue to work from and keep these available for the newer and potentially more anxious team members.
If you want to ask for something new, please try to make sure that your request is distinct from any others that are already in the queue (or part of the starter kit!). If you find one that’s similar but there are subtle differences please reference the other enhancement in your issue.
These are usually really great issues to help out with: our goal is to make it easy to understand BIDS without having to ask anyone any questions! Documentation is the ultimate solution 🏆
BIDS won’t work if people don’t use the standard! YOU are the BIDS community, and we want to know how best to support you.
The more details you can provide the better! If you know how to fix the bug, please open an issue first and then submit a pull request ✨
This label is mostly used to indicate that an old issue is about to be closed, or that a final decision is going to be made on a long running discussion. Speak now….or open a new issue when this one is gone. 😜
We’d love to hear about any opportunities for funding to keep building the BIDS Starter Kit 💰
We like to model best practice, so the BIDS Starter Kit itself is managed through these issues. We may occasionally have some to coordinate some logistics.
Making a change with a pull request¶
We appreciate all contributions to the BIDS Starter Kit.
THANK YOU for helping us build this useful resource. ✨ 🌟 💫
To make a contribution you will need to have:
a github account (see above)
python 3.8 or higher
a code editor like vs-code
To make edits you will need to:
fork the bids-starter-kit repository
clone your fork to your computer
install the dependencies
push your changes to your fork
submit a pull request
Fork the BIDS Starter Kit repository to your profile¶
This is now your own unique copy of the BIDS Starter Kit. Changes here won’t affect anyone else’s work, so it’s a safe space to explore edits to the code!
Clone your fork to your computer¶
git clone --recurse-submodules https://github.com/YOUR_USER_NAME/BIDS-Starter-Kit.git
Install the dependencies and set up pre-commit hooks¶
pip install -r requirements_dev.txt pre-commit install
Make the changes you’ve discussed¶
Try to keep the changes focused. If you submit a large amount of work in all in one go it will be much more work for whomever is reviewing your pull request. Help them help you 😉
Writing in markdown¶
GitHub has a helpful page on getting started with writing and formatting on GitHub.
Most of the writing that you’ll do will be in Markdown.
You can think of Markdown as a few little symbols around your text
that will allow GitHub to render the text with a little bit of formatting.
For example you could write words as bold (
or in italics (
or as a link (
to another webpage.
Commit your changes¶
git add . git commit -m "your commit message"
view your changes¶
jupyter-book build src
This will build the book in the
You can then open the
src/_build/html/index.html file in your browser to view the changes.
Submit a pull request¶
A member of the BIDS Starter Kit team will review your changes to confirm that they can be merged into the main codebase.
A review will probably consist of a few questions to help clarify the work you’ve done. Keep an eye on your github notifications and be prepared to join in that conversation.
You can update your fork of the BIDS Starter Kit repository and the pull request will automatically update with those changes. You don’t need to submit a new pull request when you make a change in response to a review.
Example pull request¶
BIDS follows the all-contributors specification, so we welcome and recognize all contributions from documentation to testing to code development. You can see a list of current contributors in the BIDS specification.