README.md

The DataLad handbook 📙

This is a living resource on why and - more importantly - how to use DataLad. The rendered version is here: https://handbook.datalad.org, and is currently under initial development.

The handbook is a practical, hands-on crashcourse to learn and experience DataLad. You do not need to be a programmer, computer scientist, or Linux-crank. If you have never touched your computer's shell before, you will be fine. Regardless of your background and personal use cases for DataLad, the handbook will show you the principles of DataLad, and from chapter 1 onwards you will be using them.

Find more general information about the idea behind the handbook in the poster presented at the 2020 OHBM or dive straight into your DataLad adventure.

Contributing

Contributions in any form - pull requests, issues, content requests/ideas, ... are always welcome. If you are using the handbook and find that something does not work, please let us know. Likewise, if you are using DataLad for your individual project, consider contributing by telling us about your use-case. You can find out more on how to contribute here, and a list of all contributors so far below, in CONTRIBUTORS.md, and in .zenodo.json.

Notes for Instructors

The book is the basis for workshops and lectures on DataLad and data management. The handbook's course repository among other things contains live casts from the code examples in this book and slides. It is constantly growing, and everyone is free to use the material under the license terms below. Contributions and feedback are very welcome.

License

CC-BY-SA: You are free to

• share - copy and redistribute the material in any medium or format
• adapt - remix, transform, and build upon the material for any purpose, even commercially

under the following terms:

1. Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.

2. ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Adina S. Wagner 💻 🖋 📖 🎨 🤔 🚇 🚧 📆 👀 📓 📢 ⚠️ 🐛 💡 💬 ️️️️♿️	Laura Waite 🤔 🚧 👀 📢 💬 🖋	Michael Hanke 💬 🐛 💻 🖋 📖 🎨 💡 🤔 🚇 🚧 🔌 📆 👀 🔧 ⚠️ 📢 📓 ️️️️♿️	Kyle Meyer 🐛 👀 💬 🖋 🤔	Marisa Heckner 🤔 📓 🐛 🖋	Benjamin Poldrack 💬 🤔 💡 ✅	Yaroslav Halchenko 👀 🖋 🤔 🐛
Chris Markiewicz 🐛	Pattarawat Chormai 🐛 💻	Lisa N. Mochalski 🐛 🖋 💡 🤔	Lisa Wiersch 🐛	Jean-Baptiste Poline 🖋	Nevena Kraljevic 📓	Alex Waite 👀 🐛 🤔
Lya K. Paas 🐛 💻	Niels Reuter 🖋	Peter Vavra 🤔 📓	Tobias Kadelka 📓	Peer Herholz 🤔	Alexandre Hutton 🖋 🐛	Sarah Oliveira 👀 🤔
Dorian Pustina 🤔	Hamzah Hamid Baagil 📓 🐛	Tristan Glatard 🐛 🖋	Giulia Ippoliti 🖋 💡	Christian Mönch 🖋	Togaru Surya Teja 🖋	Dorien Huijser 🐛 📓
Ariel Rokem 🐛	Remi Gau 🐛 🤔 🚧 👀 🚇 💻 🎨	Judith Bomba 🐛	Konrad Hinsen 🐛	Wu Jianxiao 🐛	Małgorzata Wierzba 📓 👀 ✅	Stefan Appelhoff 🚇 🔧 🐛
Michael Joseph 🤔 🖋 🐛	Tamara Cook 👀 🚇	Stephan Heunis 🐛 🚧 🖋 💡 👀	Joerg Stadler 🐛	Sin Kim 🐛 🖋 👀	Oscar Esteban 🐛	Michał Szczepanik 👀 🐛 🖋
eort 🐛	Myrskyta 🐛	Thomas Guiot 🐛	jhpb7 🐛	Ikko Ashimine 🐛	Arshitha Basavaraj 🖋 🐛 🚧	Anthony J Veltri 📓
Isil Bilgin 🐛 🚧	Julian Kosciessa 🖋	Isaac To 🚧 🖋 🐛	Austin Macdonald 🐛	Christopher S. Hall 🐛	jcf2 🐛	Julien Colomb 🖋
Danny Garside 🐛 🚧	Justus Kuhlmann 🖋	melanieganz 🐛	Damien François 🐛 🖋	tmheunis 🐛 📓

This project follows the all-contributors specification. Contributions of any kind welcome!