link tutorial video

docs/basic_functionalities/overview_of_ui.md

@@ -26,7 +26,7 @@ At the top right of the viewer, there are several icons guiding you to additiona
 
 From left to right you find
 
-- The help button. Here you find information about keyboard shortcuts and terms of use. You can also launch the interactive quick tour, which is launched automatically when you use siibra-explorer for the first time.
+- The help button. Here you find information about keyboard shortcuts and terms of use. You can also launch the interactive quick tour, which is launched automatically when you use `siibra-explorer` for the first time.
 - The download button, which will download the reference template and parcellation map currently displayed in the viewer
 - The plugin menu, which allows you to launch interactive plugins (see “Advanced functionalities” below)
 - The login menu, which allows you to login with an EBRAINS account to access some custom functionalities for sharing.

docs/basic_functionalities/selecting_parcellation_maps.md

 # Selecting Parcellation Maps
 
+On the bottom left of the viewer, you find selectors for choosing the species, reference space, and parcellation map. The latter two are shown only if more than one option is available.
+
+![](https://data-proxy.ebrains.eu/api/v1/buckets/reference-atlas-data/static/siibra-explorer-chips.png){ style="width:700px"}
+
+When selecting a species, a default reference space and parcellation will be automatically preselected.
+If you switch to a different reference space, `siibra-explorer` will first check if a map of the currently selected parcellation is available for the chosen space. If it is not, you will be asked to select a different parcellation.
+Vice versa, when selecting a different parcellation which is not available in the currently selected reference space, you 
+
+Maps from the Multilevel Human Atlas can be available in different reference spaces and resolutions: We provide volumetric (ICBM 2009c nonl asym, MNI Colin 27), high-resolution volumetric (BigBrain) and surface-based (fsaverage) reference spaces. If you change the reference space, you might need to change the parcellation, if it is not mapped in the selected reference space. The system will give you the advice.
+
+
 (TBD)

docs/getting_started.md

@@ -5,7 +5,14 @@
 
 Recommended browsers are up-to-date versions of [Firefox](https://www.mozilla.org/firefox) and [Google chrome](https://www.google.com/chrome). Newer versions of [Apple Safari](https://www.apple.com/safari/) also work fairly well. Note that your hardware needs to support the WebGL2 standard, which should be the case for recent devices. If in doubt, check compatibility at <https://get.webgl.org/webgl2/>. 
 
-An overview and the basic functionalities of siibra-explorer is presented in the quick tour, which is automatically launched on first use. You can always revisit the quick tour via the help menu, which can be found under the `?` icon at the top right of the UI, or using the `?` / `h` keyboard shortcut. 
+An overview and the basic functionalities of `siibra-explorer` is presented in the quick tour, which is automatically launched on first use. You can always revisit the quick tour via the help menu, which can be found under the `?` icon at the top right of the UI, or using the `?` / `h` keyboard shortcut. 
+You might also watch the following video tutorial, which covers basic functionalities of `siibra-explorer`. Note that since we are continuously adding new features to `siibra-explorer` however, the user interface shown in the video might not exactly reflect the latest version of the viewer.
 
-Using the browser on your table or mobile phone should work in many cases as well, try it out!
-![](https://data-proxy.ebrains.eu/api/v1/buckets/reference-atlas-data/static/siibra_explorer_in_mobile.png)
+
+[![](https://img.youtube.com/vi/xAU70QLLUO4/0.jpg){: style="width:500px" }](https://www.youtube.com/watch?v=xAU70QLLUO4)
+
+
+
+!!! tip "siibra-explorer runs on mobile devices!"
+	Using the browser on your table or mobile phone should work in many cases as well. Try it out!
+	![](https://data-proxy.ebrains.eu/api/v1/buckets/reference-atlas-data/static/siibra_explorer_in_mobile.png){: style="width:500px" }

docs/index.md

 # siibra-explorer - web-based viewer for exploring multi-resolution 3D brain atlases
 
 !!! tip "siibra-explorer runs on EBRAINS"
-	- Launch siibra-explorer on EBRAINS: <https://atlases.ebrains.eu/viewer/>
+	- Launch `siibra-explorer` on EBRAINS: <https://atlases.ebrains.eu/viewer/>
 	- Get EBRAINS user support: [support@ebrains.eu](mailto:support@ebrains.eu?subject=[interactive%20atlas%20viewer]%20queries)
 	- Learn about EBRAINS atlases: <https://ebrains.eu/brain-atlases/reference-atlases>. 
 
-siibra-explorer is a browser based 3D viewer for exploring brain atlases that cover different spatial resolutions and modalities. It is built around an interactive 3D view of the brain displaying a unique selection of detailed templates and parcellation maps for the human, macaque, rat or mouse brain, including BigBrain as a microscopic resolution human brain model at its full resolution of 20 micrometers. 
+`siibra-explorer` is a browser based 3D viewer for exploring brain atlases that cover different spatial resolutions and modalities. It is built around an interactive 3D view of the brain displaying a unique selection of detailed templates and parcellation maps for the human, macaque, rat or mouse brain, including BigBrain as a microscopic resolution human brain model at its full resolution of 20 micrometers. 
 
 ![](https://data-proxy.ebrains.eu/api/v1/buckets/reference-atlas-data/static/siibra-explorer-teaser.png)
 
-By selecting brain regions or zooming into user-defined regions of interest, you can find and access data features from different modalities which have been linked to the respective locations in the brain, including structural and functional connectivity, histological features such as cell and neurotransmitter densities, 2D and 3D images, and gene expressions. This way siibra-explorer allows you to explore and study brain organization in many different facets.
+By selecting brain regions or zooming into user-defined regions of interest, you can find and access data features from different modalities which have been linked to the respective locations in the brain, including structural and functional connectivity, histological features such as cell and neurotransmitter densities, 2D and 3D images, and gene expressions. This way `siibra-explorer` allows you to explore and study brain organization in many different facets.
 
 !!! info "Check out siibra's Python and HTTP interfaces"
-    siibra stands for "software interfaces for interacting with brain atlases" and includes a suite of tools of which siibra-explorer is the most immediate and intuitive entry point. If you are into programming and reproducibility however, don't miss [siibra-python](https://siibra-python.readthedocs.io) which provides all the functionality of the explorer (and more) in Python. If you are into application development, check out our http interface [siibra-api](https://siibra-api-stable.apps.hbp.eu/). 
+    siibra stands for "software interfaces for interacting with brain atlases" and includes a suite of tools of which `siibra-explorer` is the most immediate and intuitive entry point. If you are into programming and reproducibility however, don't miss [siibra-python](https://siibra-python.readthedocs.io) which provides all the functionality of the explorer (and more) in Python. If you are into application development, check out our http interface [siibra-api](https://siibra-api-stable.apps.hbp.eu/). 
 
-siibra-explorer has been developed in the frame of the [Human Brain Project](https://www.humanbrainproject.eu/en/). The main installation is hosted as a publicly accessible service inside the European research infrastructure [EBRAINS](https://ebrains.eu). All its contents are linked to publicly available curated datasets with rich metadata, mostly shared via the [EBRAINS Knowledge Graph](https://search.kg.ebrains.eu). The sourcecode of siibra-explorer is openly accessible at [github](http://github.com/fzj-inm1-bda/siibra-explorer). 
+`siibra-explorer` has been developed in the frame of the [Human Brain Project](https://www.humanbrainproject.eu/en/). The main installation is hosted as a publicly accessible service inside the European research infrastructure [EBRAINS](https://ebrains.eu). All its contents are linked to publicly available curated datasets with rich metadata, mostly shared via the [EBRAINS Knowledge Graph](https://search.kg.ebrains.eu). The sourcecode of `siibra-explorer` is openly accessible at [github](http://github.com/fzj-inm1-bda/siibra-explorer). 
 
 This documentation describes the functionalities of the software. Although it includes examples of brain templates, parcellation maps and multimodal data features, it does not  provide a catalogue of the atlas contents available in the public installation, since these are constantly growing and managed independently of the software. To see which contents are accessible, go and explore the viewer <https://atlases.ebrains.eu/viewer>. Learn more about EBRAINS brain atlases at <https://ebrains.eu/brain-atlases/reference-atlases>.