diff --git a/common/helpOnePager.md b/common/helpOnePager.md
index be7927406de2cdd4130a98f2035c3894795c5115..17fd74e4c07c0be260ec3f2156809f64d61edc35 100644
--- a/common/helpOnePager.md
+++ b/common/helpOnePager.md
@@ -11,7 +11,5 @@
| Multiple region select | `<ctrl>` + `[click]` on region | - |
| Context menu | `[right click]` | - |
----
+You can enable touch interface by `[Portrait]` > `Settings` > `Enable Mobile UI`
-
-You can enable touch interface by `[Portrait]` > `Settings` > `Enable Mobile UI`
\ No newline at end of file
diff --git a/docs/advanced_functionalities/annotating_structures.md b/docs/advanced/annotating_structures.md
similarity index 100%
rename from docs/advanced_functionalities/annotating_structures.md
rename to docs/advanced/annotating_structures.md
diff --git a/docs/advanced_functionalities/differential_gene_expression_analysis.md b/docs/advanced/differential_gene_expression_analysis.md
similarity index 100%
rename from docs/advanced_functionalities/differential_gene_expression_analysis.md
rename to docs/advanced/differential_gene_expression_analysis.md
diff --git a/docs/advanced_functionalities/superimposing_local_files.md b/docs/advanced/superimposing_local_files.md
similarity index 100%
rename from docs/advanced_functionalities/superimposing_local_files.md
rename to docs/advanced/superimposing_local_files.md
diff --git a/docs/basic_functionalities/selecting_parcellation_maps.md b/docs/basic_functionalities/selecting_parcellation_maps.md
deleted file mode 100644
index 90eaa1c28934dd5e6d80c426f7180ed5607ad3d7..0000000000000000000000000000000000000000
--- a/docs/basic_functionalities/selecting_parcellation_maps.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# 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.
-
-{ 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 parcellation which is not available as a map in the currently selected reference space, you will be asked to select a different space.
-
diff --git a/docs/basic_functionalities/exploring_3d_parcellation_maps.md b/docs/basics/exploring_3d_parcellation_maps.md
similarity index 70%
rename from docs/basic_functionalities/exploring_3d_parcellation_maps.md
rename to docs/basics/exploring_3d_parcellation_maps.md
index cf153c2bca97118ae042e9c610b916e75174635c..7ac791c72745e49f4090b161187b89ea4cf940af 100644
--- a/docs/basic_functionalities/exploring_3d_parcellation_maps.md
+++ b/docs/basics/exploring_3d_parcellation_maps.md
@@ -1,5 +1,14 @@
# Exploring 3D 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.
+
+{ 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 parcellation which is not available as a map in the currently selected reference space, you will be asked to select a different space.
+
+
In the case of a volumetric template, siibra-explorer combines a rotatable 3D surface view of a brain volume with three planar views of orthogonal image planes (coronal, sagittal, horizontal). It can visualize very large brain volumes in the Terabyte range.
{: style="width:700px" }
diff --git a/docs/basic_functionalities/finding_multimodal_data.md b/docs/basics/finding_multimodal_data.md
similarity index 100%
rename from docs/basic_functionalities/finding_multimodal_data.md
rename to docs/basics/finding_multimodal_data.md
diff --git a/docs/basic_functionalities/helperOnePager.md b/docs/basics/helperOnePager.md
similarity index 100%
rename from docs/basic_functionalities/helperOnePager.md
rename to docs/basics/helperOnePager.md
diff --git a/docs/basic_functionalities/looking_up_coordinates.md b/docs/basics/looking_up_coordinates.md
similarity index 100%
rename from docs/basic_functionalities/looking_up_coordinates.md
rename to docs/basics/looking_up_coordinates.md
diff --git a/docs/basic_functionalities/selecting_brain_regions.md b/docs/basics/selecting_brain_regions.md
similarity index 100%
rename from docs/basic_functionalities/selecting_brain_regions.md
rename to docs/basics/selecting_brain_regions.md
diff --git a/docs/basic_functionalities/storing_and_sharing_3d_views.md b/docs/basics/storing_and_sharing_3d_views.md
similarity index 54%
rename from docs/basic_functionalities/storing_and_sharing_3d_views.md
rename to docs/basics/storing_and_sharing_3d_views.md
index 12337a30bf7a9fd01fd81eed0db0a0d2073123db..00d1a1240237a95396659099279a312e217661d9 100644
--- a/docs/basic_functionalities/storing_and_sharing_3d_views.md
+++ b/docs/basics/storing_and_sharing_3d_views.md
@@ -2,21 +2,19 @@
## Bookmarks
-Any views in siibra-explorer can be shared via their URLs. You can use any native share functionality offered by your browser, or manually copy the URL.
+Any views in `siibra-explorer` can be shared via their URLs. You can use any native share functionality offered by your browser, or manually copy the URL.
!!! info
Automatic markdown renderer such as rocketchat can interfere with the rendering of the URL. To circumvent the issue, it is recommended that you generate a sane URL, or use a `code` block to escape markup
-## sane URL
+## Creating short URLs ("saneURL")
-Whilst sharing views with URLs are convenient, full URLs are lengthy, fail to be recitable or memorable. While you can use any URL shortener, siibra-explorer provide a URL shortener. To access this service, expand navigation panel, click share icon and click `Create custom URL`.
+Whilst sharing views with URLs are convenient, full URLs are lengthy, fail to be recitable or memorable. While you can use any URL shortener, `siibra-explorer` provide a URL shortener. To access this service, expand navigation panel, click share icon and click `Create custom URL`.
!!! warning
Links generated by unauthenticated users will expire automatically after 72 hours. To circumvent the expiry, ensure you are logged in using an ebrains user account. Links generated by an authenticated user does not expire.
## Taking Screenshots
-Whilst you can use any browser level or OS level screenshot tool, siibra-explorer also offers a screenshot tool. To access the screenshot tool, click `Plugin`, then select `Screenshot`.
+Whilst you can use any browser level or OS level screenshot tool, `siibra-explorer` also offers a dedicated screenshot tool which generates a clean and exact image of the current 3D view which automatically hides other user interface elements. To access the screenshot tool, click `Plugin`, then select `Screenshot`.
-!!! info
- Screenshot taken by the built in screenshot tool hides all UIs.
diff --git a/docs/basic_functionalities/overview_of_ui.md b/docs/ui/main_elements.md
similarity index 59%
rename from docs/basic_functionalities/overview_of_ui.md
rename to docs/ui/main_elements.md
index 9105c0332a8485e63e6dafb6afee36f7a4eb5d84..c7667035337050ceae5e1000885781f0df312213 100644
--- a/docs/basic_functionalities/overview_of_ui.md
+++ b/docs/ui/main_elements.md
@@ -1,26 +1,28 @@
-# Organisation of the user interface
+# Main elements of the user interface
-At its core, the viewer presents a 3D view of a brain.
+**3D view.** At its core, the viewer presents a 3D view of a brain.
The precise layout of the 3D view depends on the select reference space.
-
For volumetric reference spaces, it presents 2D views of three orthogonal planes in the reference template, combined with a rotatable 3D overview of the brain surface indicating the location of these planes.
The planes default to the coronal, sagittal and axial plane, and can be freely adjusted in position and orientation to select arbitrary oblique views.
-{ style="width:300px"}
+{ style="width:600px"}
The volumetric views support ultrahigh-resolution data, and can be zoomed in if the underlying image data allows. Each of the 3 planar views can be maximized using the "[ ]" icon in each view.
-{ style="width:300px"}
+{ style="width:600px"}
For pure surface spaces, such as the fsaverage space, the viewer shows only a 3D view.
-{ style="width:300px"}
+{ style="width:600px"}
+
+
+**Navigation panel.** At the top left of the user interface, `siibra-explorer` displays the 3D coordinate of the currently selected center of view. When you click it with the mouse pointer, a navigation panel opens, which allows to enter a different coordinates, and create a shareable link to the current view (see ["Storing and sharing 3D views"](../basics/storing_and_sharing_3d_views.md)).
-At the bottom of the window, you find buttons to switch between different species, different reference templates, and different parcellation maps. Note that buttons may be hidden in case that only one option is available.
+**Parcellation map selectors.** At the bottom of the window, you find buttons to switch between different species, different reference templates, and different parcellation maps (see ["Exploring parcellation maps"](../basics/exploring_3d_parcellation_maps.md)). Note that buttons may be hidden in case that only one option is available.
{ style="width:700px"}
-At the top right of the viewer, there are several icons guiding you to additional functionalites.
+**Additional tools.** At the top right of the viewer, there are several icons guiding you to additional functionalites.
{ style="width:250px"}
@@ -28,6 +30,6 @@ 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 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 plugin menu, which allows you to launch interactive plugins (see “Advanced functionalitiesâ€)
- The login menu, which allows you to login with an EBRAINS account to access some custom functionalities for sharing.
diff --git a/mkdocs.yml b/mkdocs.yml
index 6383d476791d846ee60277b9d22b64dd3fdafb21..057cedaf186a176d4d268d9e661de08f9d5dcc44 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -22,19 +22,19 @@ nav:
- Home: 'index.md'
- Getting Started: 'getting_started.md'
- Key concepts: 'concepts.md'
+ - User interface:
+ - Main elements: 'ui/main_elements.md'
+ - Keyboard shortcuts: 'basics/helperOnePager.md'
- Basic Functionalities:
- - Organisation of user interface: 'basic_functionalities/overview_of_ui.md'
- - Selecting parcellation maps: 'basic_functionalities/selecting_parcellation_maps.md'
- - Exploring 3D parcellation maps: 'basic_functionalities/exploring_3d_parcellation_maps.md'
- - Keyboard shortcuts: 'basic_functionalities/helperOnePager.md'
- - Storing and sharing 3D views: 'basic_functionalities/storing_and_sharing_3d_views.md'
- - Selecting brain regions: 'basic_functionalities/selecting_brain_regions.md'
- - Looking up coordinates in reference space: 'basic_functionalities/looking_up_coordinates.md'
- - Finding multimodal data: 'basic_functionalities/finding_multimodal_data.md'
+ - Exploring parcellation maps: 'basics/exploring_3d_parcellation_maps.md'
+ - Storing and sharing 3D views: 'basics/storing_and_sharing_3d_views.md'
+ - Selecting brain regions: 'basics/selecting_brain_regions.md'
+ - Looking up coordinates in reference space: 'basics/looking_up_coordinates.md'
+ - Finding multimodal data: 'basics/finding_multimodal_data.md'
- Advanced functionalities:
- - Annotating structures in the brain: "advanced_functionalities/annotating_structures.md"
- - Differential gene expression analysis: "advanced_functionalities/differential_gene_expression_analysis.md"
- - Superimposing local files: "advanced_functionalities/superimposing_local_files.md"
+ - Annotating structures in the brain: "advanced/annotating_structures.md"
+ - Differential gene expression analysis: "advanced/differential_gene_expression_analysis.md"
+ - Superimposing local files: "advanced/superimposing_local_files.md"
- Release notes:
- v2.14.0: 'releases/v2.14.0.md'