diff --git a/README.md b/README.md
index c3fbfffc78a9a563c647a8bc0023e04bf5089864..e13fb1cd8a41fe1312cf17df8604df119ec2b21e 100644
--- a/README.md
+++ b/README.md
@@ -13,8 +13,7 @@ Releases newer than [v0.2.9](https://github.com/HumanBrainProject/interactive-vi
 
 ### Prerequisites
 
-- node > 6
-- npm > 4
+- node >= 12
 
 ### Develop Interactive Viewer
 
diff --git a/docs/advanced/url.md b/docs/advanced/url.md
new file mode 100644
index 0000000000000000000000000000000000000000..94ff3d6ef4b45b7a05b0926f8819cbc273b2e48f
--- /dev/null
+++ b/docs/advanced/url.md
@@ -0,0 +1,233 @@
+# URL parsing
+
+!!! note
+    Since [version 2.0.0](../releases/v2.0.0.md), navigation state and region(s) selected has been significantly redesigned.
+
+    While the the URL parsing engine should still be backwards compatible, users should update their bookmarks/links. 
+
+The interactive atlas viewer uses query parameters to store some of the viewer state. As a result, users can share or bookmark the URL, easily collaborating with other users in an interactive environment.
+
+
+```
+https://interactive-viewer.apps.hbp.eu/?templateSelected=Big+Brain+%28Histology%29&parcellationSelected=Cytoarchitectonic+Maps&cRegionsSelected=%7B%22interpolated%22%3A%224.5.6.7.O.P%22%7D&cNavigation=0.0.0.-W000..-J0_A.2_4alZ._DTi1.2-3oKv..7LIx..jFlG~.Efml~.M7am..10c2
+```
+
+However, expert users may want to generate custom state URLs. 
+
+This document explains how the URL parsing in the Interactive Atlas Viewer work.
+
+## Query Parameters
+
+| Query param | 
+| --- | 
+| [`templateSelected`](#templateselected) | 
+| [`parcellationSelected`](#parcellationselected) |
+| [`cNavigation`](#cnavigation) | 
+| [`cRegionsSelected`](#cregionsselected) | 
+
+### `templateSelected`
+
+Describes the selected template. URI encoded value of the name of the selected template.
+
+If unset, loads homepage.
+
+__Example__
+
+```
+templateSelected=Big+Brain+%28Histology%29
+```
+
+
+### `parcellationSelected`
+
+Describes the parcellation selected. Depends on `templateSelected`. URI encoded value of the name of the selected parcellation.
+
+If unset, or not a subset of parcellations supported by the selected template, the first parcellation of the selected template will be loaded instead
+
+__Example__
+
+```
+parcellationSelected=Cytoarchitectonic+Maps
+```
+
+### `cNavigation`
+
+Describes the navigation state of the viewer.
+
+Uses `..` as a delimiter for key value, `.` as a delimiter for value and [hash function](#hash-function) to encode signed float to base64 string.
+
+If unset, loads the default orientation.
+
+__Example__
+
+```
+cNavigation=0.0.0.-W000..-J0_A.2_4alZ._DTi1.2-3oKv..7LIx..jFlG~.Efml~.M7am..10c2
+```
+
+```javascript
+// cNavigation=0.0.0.-W000..-J0_A.2_4alZ._DTi1.2-3oKv..7LIx..jFlG~.Efml~.M7am..10c2
+
+const cNavigation = `0.0.0.-W000..-J0_A.2_4alZ._DTi1.2-3oKv..7LIx..jFlG~.Efml~.M7am..10c2`
+
+// First, separate with key value delimiter
+const [
+  orientationStr,
+  perspectiveOrientationStr,
+  perspectiveZoomStr,
+  positionStr,
+  zoomStr  
+] = cNavigation.split('..')
+
+// For entries that are Array:
+
+const orientationArr = orientationStr.split('.')
+const perspectiveOrientationArr = perspectiveOrientationStr.split('.')
+const positionArr = positionStr.split('.')
+
+
+// check hash function for decodeToNumber
+// To get values back:
+const orientation = orientationArr.map(v => decodeToNumber(v, { float: true }))
+// [ 0, 0, 0, 1 ]
+
+
+const perspectiveOrientation = perspectiveOrientationArr.map(v => decodeToNumber(v, { float: true }))
+// [ 0.7971121072769165,  -0.14286760985851288,  0.17759324610233307,  -0.5591617226600647 ]
+
+const zoom = decodeToNumber(zoomStr, { float: false })
+// 264578
+
+const perspectiveZoom = decodeToNumber(perspectiveZoomStr, { float: false })
+// 1922235
+
+const position = positionArr.map(v => decodeToNumber(v, { float: false }))
+// [ -11860944, -3841071, 5798192 ]
+
+```
+
+
+### `cRegionsSelected`
+
+Describe the regions selected.
+
+Query value is an URI encoded JSON object. Upon decoding, keys represent the name of the segmentation layer (which is often different to _selected parcellation_). Value is a `.` delimited array of integer [hashed](#hash-function) to base64 string.
+
+If unset, or if unable to decode, does not select region.
+
+__Example__
+
+```
+cRegionsSelected=%7B%22interpolated%22%3A%224.5.6.7.O.P%22%7D
+```
+
+```javascript
+const cRegionSelected = `%7B%22interpolated%22%3A%224.5.6.7.O.P%22%7D`
+const decoded = decodeURIComponent(cRegionSelected)
+
+const parsed = JSON.parse(decoded)
+const returnObj = {}
+for (const key in parsed){
+  const seg = parsed[key].split('.').map(v => decodeToNumber(v, { float: false }))
+  returnObj[key] = seg
+}
+
+// { interpolated: [ 4, 5, 6, 7, 24, 25 ] }
+
+```
+
+## hash function
+
+```javascript
+
+/**
+ * First attempt at encoding int (e.g. selected region, navigation location) from number (loc info density) to b64 (higher info density)
+ * The constraint is that the cipher needs to be commpatible with URI encoding
+ * and a URI compatible separator is required. 
+ * 
+ * The implementation below came from 
+ * https://stackoverflow.com/a/6573119/6059235
+ * 
+ * While a faster solution exist in the same post, this operation is expected to be done:
+ * - once per 1 sec frequency
+ * - on < 1000 numbers
+ * 
+ * So performance is not really that important (Also, need to learn bitwise operation)
+ */
+
+const cipher = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_-'
+export const separator = "."
+const negString = '~'
+
+const encodeInt = number => {
+  if (number % 1 !== 0) throw 'cannot encodeInt on a float. Ensure float flag is set'
+  if (isNaN(Number(number)) || number === null || number === Number.POSITIVE_INFINITY) throw 'The input is not valid'
+
+  let rixit // like 'digit', only in some non-decimal radix 
+  let residual
+  let result = ''
+
+  if (number < 0) {
+    result += negString
+    residual = Math.floor(number * -1)
+  } else {
+    residual = Math.floor(number)
+  }
+
+  while (true) {
+    rixit = residual % 64
+    // console.log("rixit : " + rixit)
+    // console.log("result before : " + result)
+    result = cipher.charAt(rixit) + result
+    // console.log("result after : " + result)
+    // console.log("residual before : " + residual)
+    residual = Math.floor(residual / 64)
+    // console.log("residual after : " + residual)
+
+    if (residual == 0)
+      break;
+    }
+  return result
+}
+
+const defaultB64EncodingOption = {
+  float: false
+}
+
+export const encodeNumber = (number, option = defaultB64EncodingOption) => {
+  if (!float) return encodeInt(number)
+  else {
+    const floatArray = new Float32Array(1)
+    floatArray[0] = number
+    const intArray = new Uint32Array(floatArray.buffer)
+    const castedInt = intArray[0]
+    return encodeInt(castedInt)
+  }
+}
+
+const decodetoInt = encodedString => {
+  let _encodedString, negFlag = false
+  if (encodedString.slice(-1) === negString) {
+    negFlag = true
+    _encodedString = encodedString.slice(0, -1)
+  } else {
+    _encodedString = encodedString
+  }
+  return (negFlag ? -1 : 1) * [..._encodedString].reduce((acc,curr) => {
+    const index = cipher.indexOf(curr)
+    if (index < 0) throw new Error(`Poisoned b64 encoding ${encodedString}`)
+    return acc * 64 + index
+  }, 0)
+}
+
+export const decodeToNumber = (encodedString, {float = false} = defaultB64EncodingOption) => {
+  if (!float) return decodetoInt(encodedString)
+  else {
+    const _int = decodetoInt(encodedString)
+    const intArray = new Uint32Array(1)
+    intArray[0] = _int
+    const castedFloat = new Float32Array(intArray.buffer)
+    return castedFloat[0]
+  }
+}
+
+```
diff --git a/docs/extra.css b/docs/extra.css
index 4dda2e6991ce81026bc0541eb123cf411ac72688..5141ee2eea1f5ea4ff67f676b994bf530e63f676 100644
--- a/docs/extra.css
+++ b/docs/extra.css
@@ -9,7 +9,7 @@ div.autodoc-members {
   margin-bottom: 15px;
 }
 
-/* img {
+img {
   width: 50%;
-  display: block;
-} */
\ No newline at end of file
+  display: inline-block;
+}
\ No newline at end of file
diff --git a/docs/navigation.md b/docs/navigation.md
deleted file mode 100644
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..0000000000000000000000000000000000000000
diff --git a/docs/usage/gettingStarted.md b/docs/usage/gettingStarted.md
index 58e718b9bfdb76eab63bd41e5c1b5a78053f220c..c6180907d0e9a90e89091f6108b7c1acdc9eb105 100644
--- a/docs/usage/gettingStarted.md
+++ b/docs/usage/gettingStarted.md
@@ -1,4 +1,4 @@
-# Getting Started
+# Getting started
 
 ## Requirements
 
@@ -8,11 +8,18 @@ Interactive Atlas Viewer uses webgl 2.0 under the hood. While modern operating s
     To check if your device support webgl 2.0, you can visit <https://get.webgl.org/webgl2/>.
 
 ### Desktop
+
+!!! tip
+    If you have a touch enabled device, you can enable mobile UI via:
+
+    `Click on Portrait` > `Settings` > `Enable Mobile UI`
+
 - PC (Windows/Linux/MacOS)
 - Chrome/Firefox
 - Dedicated GPU (not required, but will greatly enhance the experience)
 
 ### Mobile
+
 - Android Smartphone
 - Chrome/Firefox
 
diff --git a/docs/usage/images/area_te10_detail.png b/docs/usage/images/area_te10_detail.png
new file mode 100644
index 0000000000000000000000000000000000000000..3e37b84f7734b267210c7a613fe6ddc4de096a6a
Binary files /dev/null and b/docs/usage/images/area_te10_detail.png differ
diff --git a/docs/usage/images/bigbrain_click_dataset.png b/docs/usage/images/bigbrain_click_dataset.png
new file mode 100644
index 0000000000000000000000000000000000000000..897f1acd5c3fb312ce21c98ac061a6b270fa7514
Binary files /dev/null and b/docs/usage/images/bigbrain_click_dataset.png differ
diff --git a/docs/usage/images/bigbrain_collapse_search.png b/docs/usage/images/bigbrain_collapse_search.png
new file mode 100644
index 0000000000000000000000000000000000000000..cc3fab629b9e1bce28fe61482a2e8a4dcb57ffe5
Binary files /dev/null and b/docs/usage/images/bigbrain_collapse_search.png differ
diff --git a/docs/usage/images/bigbrain_explore_the_current_view.png b/docs/usage/images/bigbrain_explore_the_current_view.png
new file mode 100644
index 0000000000000000000000000000000000000000..a539b7be8b4001edc9804545fff9509c581f8076
Binary files /dev/null and b/docs/usage/images/bigbrain_explore_the_current_view.png differ
diff --git a/docs/usage/images/bigbrain_full_hierarchy.png b/docs/usage/images/bigbrain_full_hierarchy.png
new file mode 100644
index 0000000000000000000000000000000000000000..287fe8deac14dbe53a029bd2adeaea49d94c2b7b
Binary files /dev/null and b/docs/usage/images/bigbrain_full_hierarchy.png differ
diff --git a/docs/usage/images/bigbrain_info_btn.png b/docs/usage/images/bigbrain_info_btn.png
new file mode 100644
index 0000000000000000000000000000000000000000..495b598abb8bc6a00f51041fcf5bf46ea471791a
Binary files /dev/null and b/docs/usage/images/bigbrain_info_btn.png differ
diff --git a/docs/usage/images/bigbrain_mass_select_regions.png b/docs/usage/images/bigbrain_mass_select_regions.png
new file mode 100644
index 0000000000000000000000000000000000000000..cb9c0061eaf450d49b76e1f7d9cd6b78e410b9df
Binary files /dev/null and b/docs/usage/images/bigbrain_mass_select_regions.png differ
diff --git a/docs/usage/images/bigbrain_moreinfo.png b/docs/usage/images/bigbrain_moreinfo.png
new file mode 100644
index 0000000000000000000000000000000000000000..c47e5e1b12301a7771f4b53e79f84129f8ee53dd
Binary files /dev/null and b/docs/usage/images/bigbrain_moreinfo.png differ
diff --git a/docs/usage/images/bigbrain_parcellation_selector_open.png b/docs/usage/images/bigbrain_parcellation_selector_open.png
new file mode 100644
index 0000000000000000000000000000000000000000..ee4fbbf82b11fc7bc3de6015cb2d01b7dcf25ed6
Binary files /dev/null and b/docs/usage/images/bigbrain_parcellation_selector_open.png differ
diff --git a/docs/usage/images/bigbrain_quicksearch.png b/docs/usage/images/bigbrain_quicksearch.png
new file mode 100644
index 0000000000000000000000000000000000000000..e4d380a3e59e6ab177c7f7bca8be1a0fb4c9fc6d
Binary files /dev/null and b/docs/usage/images/bigbrain_quicksearch.png differ
diff --git a/docs/usage/images/bigbrain_quicksearch_hoc.png b/docs/usage/images/bigbrain_quicksearch_hoc.png
new file mode 100644
index 0000000000000000000000000000000000000000..28cea6a6bd20d35e7f7ae44d49e58e57418b618e
Binary files /dev/null and b/docs/usage/images/bigbrain_quicksearch_hoc.png differ
diff --git a/docs/usage/images/bigbrain_region_hierarchy.png b/docs/usage/images/bigbrain_region_hierarchy.png
new file mode 100644
index 0000000000000000000000000000000000000000..012d126caa3b3db4e88e6f5bbb90267528c38d06
Binary files /dev/null and b/docs/usage/images/bigbrain_region_hierarchy.png differ
diff --git a/docs/usage/images/bigbrain_region_onhover.png b/docs/usage/images/bigbrain_region_onhover.png
new file mode 100644
index 0000000000000000000000000000000000000000..aa7ab7c27885f730f9966b28fb4e7aaad1b6e892
Binary files /dev/null and b/docs/usage/images/bigbrain_region_onhover.png differ
diff --git a/docs/usage/images/bigbrain_region_specific_dialog.png b/docs/usage/images/bigbrain_region_specific_dialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..1486c00aa96c8609241edfea70374e72e07014a2
Binary files /dev/null and b/docs/usage/images/bigbrain_region_specific_dialog.png differ
diff --git a/docs/usage/images/bigbrain_search_filter.png b/docs/usage/images/bigbrain_search_filter.png
new file mode 100644
index 0000000000000000000000000000000000000000..7524ea1c153e4236dc684adb2f568c002097515e
Binary files /dev/null and b/docs/usage/images/bigbrain_search_filter.png differ
diff --git a/docs/usage/images/bigbrain_search_filter_expanded.png b/docs/usage/images/bigbrain_search_filter_expanded.png
new file mode 100644
index 0000000000000000000000000000000000000000..c757a093294a38302b7c66d91ca3e6f4b6a11bbf
Binary files /dev/null and b/docs/usage/images/bigbrain_search_filter_expanded.png differ
diff --git a/docs/usage/images/bigbrain_search_filter_reset.png b/docs/usage/images/bigbrain_search_filter_reset.png
new file mode 100644
index 0000000000000000000000000000000000000000..4e6b2c0795800747cde373ea675b849f588fb5ae
Binary files /dev/null and b/docs/usage/images/bigbrain_search_filter_reset.png differ
diff --git a/docs/usage/images/bigbrain_search_interface.png b/docs/usage/images/bigbrain_search_interface.png
new file mode 100644
index 0000000000000000000000000000000000000000..663a0fac268915eb800cb21e3f2049b64876cf2f
Binary files /dev/null and b/docs/usage/images/bigbrain_search_interface.png differ
diff --git a/docs/usage/images/bigbrain_viewer.png b/docs/usage/images/bigbrain_viewer.png
new file mode 100644
index 0000000000000000000000000000000000000000..0bf9578b3a2aaf95a887bf593ee0217b81c173d7
Binary files /dev/null and b/docs/usage/images/bigbrain_viewer.png differ
diff --git a/docs/usage/images/mni152_parcellation_selector_open.png b/docs/usage/images/mni152_parcellation_selector_open.png
deleted file mode 100644
index cee14c0a4e0950ec62aab3a2ac5ef11eafc574a8..0000000000000000000000000000000000000000
Binary files a/docs/usage/images/mni152_parcellation_selector_open.png and /dev/null differ
diff --git a/docs/usage/images/navigation_status.png b/docs/usage/images/navigation_status.png
new file mode 100644
index 0000000000000000000000000000000000000000..2c5cdec4060ff560297a4d8d4ee2c7fa5e5b39ef
Binary files /dev/null and b/docs/usage/images/navigation_status.png differ
diff --git a/docs/usage/images/viewer.png b/docs/usage/images/viewer.png
new file mode 100644
index 0000000000000000000000000000000000000000..544fb6cd1d716b25cdeaa9934c90bca9b1cb1f66
Binary files /dev/null and b/docs/usage/images/viewer.png differ
diff --git a/docs/usage/navigating.md b/docs/usage/navigating.md
new file mode 100644
index 0000000000000000000000000000000000000000..3a4794a3dda094e49cc9a4d37307620e1c6558ec
--- /dev/null
+++ b/docs/usage/navigating.md
@@ -0,0 +1,48 @@
+# Navigation
+
+## Navigating the viewer
+
+The interactive atlas viewer can be accessed via either a desktop with a Chrome or Firefox browser or an Android phone or tablet. The navigation gestures vary slightly between the two platforms.
+
+| | Desktop | Mobile |
+| --- | --- | --- |
+| Translating / Panning | `click drag` on any _slice views_ | `touchmove` on any _slice views_ |
+| Oblique rotation | `shift` + `click drag` on any _slice views_ | hold `🌏` + `drag up/down` to switch rotation mode<br> hold 🌏 + `drag left/right` to rotate |
+| Zooming (_slice view_, _3d view_) | `mouse wheel` | `pinch zoom` |
+| Next slice (_slice view_) | `ctrl` + `mouse wheel` | |
+| Next 10 slice (_slice view_) | `ctrl` + `shift` + `mouse wheel` | |
+
+## Navigate to region of interest
+
+!!! warning
+    Not all regions have a position of interest defined. If absent, the UI would simply be missing.
+    
+    If you believe some regions should have a position of interest defined, or the position of interest was incorrectly defined, please let us know. 
+
+### From viewer
+
+`click` on a segmented region will bring up a region specific dialog
+
+[![](images/bigbrain_region_specific_dialog.png)](images/bigbrain_region_specific_dialog.png)
+
+From here, `click` on `Navigate`.
+
+### From quick search
+
+`click` on the map icon.
+
+[![](images/bigbrain_quicksearch_hoc.png)](images/bigbrain_quicksearch_hoc.png)
+
+### From hierarchy tree
+
+`double click` on the region of interest. 
+
+[![](images/bigbrain_full_hierarchy.png)](images/bigbrain_full_hierarchy.png)
+
+## Navigation status panel
+
+You can find navigation status of the viewer at the lower left corner. You can reset the `position`, `rotation` and/or `zoom`. 
+
+You can also change the units between `physical` (mm) and `voxel` from the image space.
+
+[![](images/navigation_status.png)](images/navigation_status.png)
diff --git a/docs/usage/search.md b/docs/usage/search.md
new file mode 100644
index 0000000000000000000000000000000000000000..b8931ba13318e1ec045ab07810a3b51b5ba6dc49
--- /dev/null
+++ b/docs/usage/search.md
@@ -0,0 +1,44 @@
+# Search Knowldge Graph
+
+The interactive viewer fetches datasets semantically linked to [selected regions](selecting.md#selecting-deselecting-regions). If no regions are selected, all datasets associated with a parcellation will be returned.
+
+[![](images/bigbrain_search_interface.png)](images/bigbrain_search_interface.png)
+
+## Open / Close the search interface
+
+The search interface will opened by either:
+
+- [selecting any region](selecting.md#selecting-deselecting-regions)
+- manually, `click` on `Explore`
+
+[![](images/bigbrain_explore_the_current_view.png)](images/bigbrain_explore_the_current_view.png)
+
+The search interface can be closed by clicking the `Collapse` button
+[![](images/bigbrain_collapse_search.png)](images/bigbrain_collapse_search.png)
+
+## Browser dataset
+
+`click` on any dataset entry to get a detail view of the said dataset
+
+[![](images/bigbrain_click_dataset.png)](images/bigbrain_click_dataset.png)
+
+[![](images/area_te10_detail.png)](images/area_te10_detail.png)
+
+## Filter / Unfilter results
+
+You can narrow down the search result by filtering. Currently, the only filter available is by methods.
+
+`click` the banner `Related Datasets` to reveal the filter options. select all methods of interest (selecting none will apply no filter). 
+
+[![](images/bigbrain_search_filter.png)](images/bigbrain_search_filter.png)
+
+[![](images/bigbrain_search_filter_expanded.png)](images/bigbrain_search_filter_expanded.png)
+
+!!! warning
+    Selecting no filter option is not the same as selecting all options. 
+    
+    There may be datasets without any _methods_ defined. These datasets will be shown if no filter is applied (deselecting all options), but will not show up if all options are selected
+
+To reset all filters, `click` the `filter icon`
+
+[![](images/bigbrain_search_filter_reset.png)](images/bigbrain_search_filter_reset.png)
\ No newline at end of file
diff --git a/docs/usage/selecting.md b/docs/usage/selecting.md
index f4ced3a6c3d50af59d6ab3e0e8f148f16e3431e0..51c1fb43453e960fe7407283c5c8f6e765a105c3 100644
--- a/docs/usage/selecting.md
+++ b/docs/usage/selecting.md
@@ -1,19 +1,80 @@
-# Selecting Template/Parcellation
+# Selection
+
+## Selecting a template / an atlas
 
 Interactive Atlas Viewer supports a number of atlases.
 
-## From Homepage
+### From homepage
 
 At the home page, the atlases are categorised under the template space.
 
-![](images/home.png)
+[![](images/home.png)](images/home.png)
 
 Click on any of the parcellation listed, the interactive atlas viewer will load the parcellation in the corresponding template space
 
 Clicking on the template card will load the template and the first parcellation in the corresponding template space.
 
-## From Viewer
+### From viewer
 
 If an atlas is already loaded, the list of available templates and parcellation can be accessed from the side bar.
 
-![](images/mni152_parcellation_selector_open.png)
\ No newline at end of file
+[![](images/bigbrain_parcellation_selector_open.png)](images/bigbrain_parcellation_selector_open.png)
+
+
+### Information on the selected template / parcellation
+
+Information on the selected template or parcellation can be revealed by `hovering` or `tapping` the `info` button
+
+[![](images/bigbrain_info_btn.png)](images/bigbrain_info_btn.png)
+
+[![](images/bigbrain_moreinfo.png)](images/bigbrain_moreinfo.png)
+
+## Browsing regions
+
+An atlas will likely contain parcellated regions of interest. The interactive atlas viewer presents several ways of browsing the regions of interest.
+
+### From viewer
+
+Each of the region is represented as a coloured segmentation in _slice views_ (and in most circumstances in _3d view_ as well). `mouse hover` on the segment will bring up a contextual menu, showing the name of the region.
+
+[![](images/bigbrain_region_onhover.png)](images/bigbrain_region_onhover.png)
+
+### From quick search
+
+The interactive atlas viewer provides a quick search tool, which allow user to quickly find a region of interest by keyword
+
+[![](images/bigbrain_quicksearch.png)](images/bigbrain_quicksearch.png)
+
+[![](images/bigbrain_quicksearch_hoc.png)](images/bigbrain_quicksearch_hoc.png)
+
+### From hierarchy tree
+
+To view the full hierarchy, `click` the _hierarchy tree_ button. 
+
+[![](images/bigbrain_region_hierarchy.png)](images/bigbrain_region_hierarchy.png)
+
+[![](images/bigbrain_full_hierarchy.png)](images/bigbrain_full_hierarchy.png)
+
+## Selecting / Deselecting region(s)
+
+Selecting region(s) indicate a certain level of interest of these regions. Additional information on the selected regions, such as region descriptions, semantically linked datasets and so on, will be [fetched and displayed](search.md).
+
+### From viewer
+
+`click` on a segmented region will bring up a region specific dialog
+
+[![](images/bigbrain_region_specific_dialog.png)](images/bigbrain_region_specific_dialog.png)
+
+From here, `click` on `[] Selected` checkbox will select or deselect the region.
+
+### From quick search
+
+`click` on the name or the checkbox will select or deselect the region.
+
+[![](images/bigbrain_quicksearch_hoc.png)](images/bigbrain_quicksearch_hoc.png)
+
+### From hierarchy tree
+
+`click` on any _region_ or _parent region_ will (mass) select / deselect the region(s). 
+
+[![](images/bigbrain_mass_select_regions.png)](images/bigbrain_mass_select_regions.png)
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 4c421567e3f3068f7f318097d8b97688cbc0543e..8aeb907d8985ee76a5551312646820b2e7dccfec 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -16,10 +16,14 @@ markdown_extensions:
 pages:
   - Home: 'index.md'
   - User documentation:
-    - Getting Started: 'usage/gettingStarted.md'
-    - Selecting Template/Parcellation: 'usage/selecting.md'
+    - Getting started: 'usage/gettingStarted.md'
+    - Selection: 'usage/selecting.md'
+    - Navigation: 'usage/navigating.md'
+    - Search KG: 'usage/search.md'
+  - Advanced usage:
+    - URL parsing: 'advanced/url.md'
   - Release notes:
-    - v2.0.2: 'releases/v2.0.2.md'
+    - v2.0.2 (latest): 'releases/v2.0.2.md'
     - v2.0.1: 'releases/v2.0.1.md'
     - v2.0.0: 'releases/v2.0.0.md'
     - v0.3.0-beta: 'releases/v0.3.0-beta.md'