--- a
+++ b/README.md
@@ -0,0 +1,72 @@
+# Spine Generic Public Database (Single Subject)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4299148.svg)](https://doi.org/10.5281/zenodo.4299148)
+[![BIDS Validator](https://github.com/spine-generic/data-single-subject/workflows/BIDS%20Validator/badge.svg)](https://github.com/spine-generic/data-single-subject/actions?query=workflow%3A%22BIDS+Validator%22)
+
+## About this dataset
+
+This dataset was acquired using the [spine-generic protocol](http://spinalcordmri.org/protocols)
+on a 38 y.o. male healthy subject. The list of sites is available in [participants.tsv](./participants.tsv).
+
+This dataset follows the [BIDS](https://bids.neuroimaging.io/) convention.
+
+The contributor has the necessary ethics & permissions to share the data publicly.
+
+The dataset does not include any identifiable personal health information, including names,
+zip codes, dates of birth, facial features on structural scans.
+
+The entire dataset is about **1GB**.
+
+## Download
+
+We are using a tool to manage large datasets called `git-annex`. To download, dataset, you need to have `git` installed, and also [install `git-annex`](https://git-annex.branchable.com/install/) *of version 8*. Then run:
+
+~~~
+git clone https://github.com/spine-generic/data-single-subject && \
+cd data-single-subject && \
+git annex init && \
+git annex get
+~~~
+
+You may **substitute** `git annex get` with more specific commands if you are only interested in certain subjects. For example:
+
+```
+git annex get sub-douglas sub-juntendoPrisma/anat/
+```
+
+## Working from a forked repository
+
+> ⚠️ For advanced users only. Normally the instructions under [Download](#Download) should be enough.
+If you have forked this repository on Github (so that you have a copy `your-user-name/data-single-subject` of `spine-generic/data-single-subject`), you will need to take a few extra synchronization steps to get the latest data with `git annex get`. Otherwise, you may get an error message like:
+```
+get some-file-name.nii.gz (not available)
+  No other repository is known to contain the file.
+  (Note that these git remotes have annex-ignore set: origin)
+failed
+```
+
+1. In your local clone of `your-user-name/data-single-subject`, make sure that `spine-generic/data-single-subject` is also configured as a remote:
+   ```
+   git remote -v
+   # the answer should show both your-user-name/data-single-subject.git (probably named "origin")
+   # and spine-generic/data-single-subject (probably named "upstream")
+   ```
+
+   If `spine-generic/data-single-subject` is missing, you can add it with:
+   ```
+   git remote add upstream https://github.com/spine-generic/data-single-subject.git
+   git config remote.upstream.annex-readonly true
+   ```
+
+2. Then, to update your local clone, make sure to fetch the `git-annex` branch from `spine-generic/data-single-subject` before running `git annex get`:
+   ```
+   git fetch upstream +refs/heads/git-annex:refs/remotes/upstream/git-annex
+   git pull && git annex get .
+   ```
+
+## Analysis
+
+The instructions to process this dataset are available in the [spine-generic documentation](https://spine-generic.readthedocs.io/en/latest/analysis-pipeline.html).
+
+## Contributing
+
+If you wish to contribute to this dataset please see [the wiki](https://github.com/spine-generic/spine-generic/wiki/git-annex). Thank you for your contribution 🎉