You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hop.apache.org by ha...@apache.org on 2021/04/13 19:19:36 UTC

[incubator-hop-docs] branch asf-site updated: HOP-2711, HOP-2743, several minor updates and changes

This is an automated email from the ASF dual-hosted git repository.

hansva pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/incubator-hop-docs.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new a3a5839  HOP-2711, HOP-2743, several minor updates and changes
     new ca2656e  Merge pull request #72 from bamaer/HOP-2711
a3a5839 is described below

commit a3a5839b3b58fcf5a2afe9255e9efb4971869d7b
Author: Bart Maertens <ba...@know.bi>
AuthorDate: Tue Apr 13 21:17:37 2021 +0200

    HOP-2711, HOP-2743, several minor updates and changes
---
 .../modules/ROOT/assets/images/icons/data_orch.svg | 16 ++++++++
 .../modules/ROOT/assets/images/icons/metadata.svg  | 11 ++++++
 .../ROOT/assets/images/icons/neo4j_logo.svg        | 45 ++++++++++++++++++++++
 .../modules/ROOT/assets/images/icons/plugin.svg    | 15 ++++++++
 .../modules/ROOT/assets/images/icons/search.svg    | 16 ++++++++
 hop-user-manual/modules/ROOT/nav.adoc              |  3 +-
 .../modules/ROOT/pages/hop-gui/hop-gui-git.adoc    |  3 ++
 .../hop-gui/perspective-data-orchestration.adoc    |  8 ++++
 .../pages/hop-gui/perspective-file-explorer.adoc   | 11 ++++++
 .../ROOT/pages/hop-gui/perspective-metadata.adoc   |  8 ++++
 .../ROOT/pages/hop-gui/perspective-neo4.adoc       | 14 +++++++
 .../ROOT/pages/hop-gui/perspective-plugin.adoc     |  8 ++++
 .../ROOT/pages/hop-gui/perspective-search.adoc     | 14 +++++++
 .../modules/ROOT/pages/hop-gui/perspectives.adoc   | 18 ++++++++-
 .../modules/ROOT/pages/hop-gui/shortcuts.adoc      | 15 ++++++++
 .../modules/ROOT/pages/hop-tools/hop-search.adoc   |  3 ++
 .../modules/ROOT/pages/hop-tools/index.adoc        |  2 +-
 .../modules/ROOT/pages/password/passwords.adoc     |  6 +++
 .../modules/ROOT/pages/plugins/plugins.adoc        | 22 ++++++-----
 .../modules/ROOT/pages/samples/dummy-sample.adoc   |  2 +-
 .../modules/ROOT/pages/samples/samples.adoc        |  2 +-
 21 files changed, 228 insertions(+), 14 deletions(-)

diff --git a/hop-user-manual/modules/ROOT/assets/images/icons/data_orch.svg b/hop-user-manual/modules/ROOT/assets/images/icons/data_orch.svg
new file mode 100644
index 0000000..ab6c680
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/assets/images/icons/data_orch.svg
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generator: Adobe Illustrator 18.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   version="1.1"
+   x="0px"
+   y="0px"
+   viewBox="0 0 16 16"
+   enable-background="new 0 0 16 16"
+   >
+<polygon
+   points="4.4,8 1,8 1,8.4 4.3,8.4 3.1,11.7 12.4,8.4 15,8.4 15,8 12.6,8 3.1,4.6 "
+   transform="matrix(0.83333086,-0.76443337,0.72622646,0.87717255,-4.1160486,6.084217)"
+   style="fill:#0e3a5a" />
+</svg>
\ No newline at end of file
diff --git a/hop-user-manual/modules/ROOT/assets/images/icons/metadata.svg b/hop-user-manual/modules/ROOT/assets/images/icons/metadata.svg
new file mode 100644
index 0000000..7cfd49b
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/assets/images/icons/metadata.svg
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns="http://www.w3.org/2000/svg"
+   viewBox="0 0 24 24"
+   height="24"
+   width="24"
+   version="1.1">
+  <path
+     style="fill:#0e3a5a;fill-opacity:1;stroke-width:1.33201"
+     d="m 8.0396825,5.3756614 h 7.9920635 a 2.6640211,2.6640211 0 0 1 2.664021,2.6640211 V 18.695767 H 16.031746 V 8.0396825 H 13.367725 V 17.363756 H 10.703704 V 8.0396825 H 8.0396825 V 18.695767 H 5.3756614 V 8.0396825 A 2.6640211,2.6640211 0 0 1 8.0396825,5.3756614 M 2.7116402,0.04761905 H 21.359789 A 2.6640211,2.6640211 0 0 1 24.02381,2.7116402 V 21.359789 A 2.6640211,2.6640211 0 0 1 21.359789,24.02381 H 2.7116402 A 2.6640211,2.6640211 0 0 1 0.04761905,21.359789 V 2.7116402 A 2.66402 [...]
+</svg>
diff --git a/hop-user-manual/modules/ROOT/assets/images/icons/neo4j_logo.svg b/hop-user-manual/modules/ROOT/assets/images/icons/neo4j_logo.svg
new file mode 100644
index 0000000..cf32559
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/assets/images/icons/neo4j_logo.svg
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns="http://www.w3.org/2000/svg"
+   viewBox="0 0 533.33331 533.33331"
+   height="533.33331"
+   width="533.33331"
+   xml:space="preserve"
+   version="1.1">
+  <g
+     transform="matrix(1.3333333,0,0,-1.3333333,0,533.33333)"
+     id="g3726"><g
+       transform="scale(0.1)"
+       id="g3728">
+  <path
+         style="fill:#208cc7;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 3255.98,2150.96 c 0,-717.72 -581.83,-1299.55 -1299.55,-1299.55 -717.73,0 -1299.559,581.83 -1299.559,1299.55 0,717.72 581.829,1299.55 1299.559,1299.55 717.72,0 1299.55,-581.83 1299.55,-1299.55" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 1233.6,2576.83 c 0,-57.39 -46.56,-103.96 -103.96,-103.96 -57.43,0 -103.97,46.57 -103.97,103.96 0,57.45 46.54,103.97 103.97,103.97 57.4,0 103.96,-46.52 103.96,-103.97" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 1250.77,2291.94 c 0,-57.39 -46.56,-103.96 -103.96,-103.96 -57.43,0 -103.97,46.57 -103.97,103.96 0,57.45 46.54,103.96 103.97,103.96 57.4,0 103.96,-46.51 103.96,-103.96" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 1314.42,1989.87 c 0,-57.39 -46.56,-103.96 -103.96,-103.96 -57.43,0 -103.97,46.57 -103.97,103.96 0,57.45 46.54,103.97 103.97,103.97 57.4,0 103.96,-46.52 103.96,-103.97" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 1457.04,1719.15 c 0,-57.38 -46.56,-103.96 -103.96,-103.96 -57.43,0 -103.97,46.58 -103.97,103.96 0,57.46 46.54,103.97 103.97,103.97 57.4,0 103.96,-46.51 103.96,-103.97" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 2569.19,1340.59 c 0,-57.38 -46.56,-103.96 -103.97,-103.96 -57.43,0 -103.96,46.58 -103.96,103.96 0,57.46 46.53,103.97 103.96,103.97 57.41,0 103.97,-46.51 103.97,-103.97" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 2757.95,1564.02 c 0,-57.38 -46.56,-103.96 -103.97,-103.96 -57.43,0 -103.96,46.58 -103.96,103.96 0,57.46 46.53,103.97 103.96,103.97 57.41,0 103.97,-46.51 103.97,-103.97" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 2210.13,3143.99 c 0,-57.38 -46.56,-103.96 -103.96,-103.96 -57.43,0 -103.97,46.58 -103.97,103.96 0,57.45 46.54,103.97 103.97,103.97 57.4,0 103.96,-46.52 103.96,-103.97" /><path
+         style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 1937.4,3239.81 c 0,-57.39 -46.56,-103.96 -103.96,-103.96 -57.43,0 -103.97,46.57 -103.97,103.96 0,57.45 46.54,103.97 103.97,103.97 57.4,0 103.96,-46.52 103.96,-103.97" /><path
+         style="fill:#59b734;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 3366.55,2460.28 c 0,-382.48 -310.06,-692.53 -692.53,-692.53 -382.48,0 -692.53,310.05 -692.53,692.53 0,382.47 310.05,692.52 692.53,692.52 382.47,0 692.53,-310.05 692.53,-692.52" /><path
+         style="fill:none;stroke:#ffffff;stroke-width:50;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;stroke-dasharray:none;stroke-opacity:1"
+         d="m 3366.55,2460.28 c 0,-382.48 -310.06,-692.53 -692.53,-692.53 -382.48,0 -692.53,310.05 -692.53,692.53 0,382.47 310.05,692.52 692.53,692.52 382.47,0 692.53,-310.05 692.53,-692.52 z" /><path
+         style="fill:#59b734;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 2291.31,1048.58 c 0,-312.932 -253.68,-566.611 -566.61,-566.611 -312.93,0 -566.62,253.679 -566.62,566.611 0,312.93 253.69,566.61 566.62,566.61 312.93,0 566.61,-253.68 566.61,-566.61" /><path
+         style="fill:none;stroke:#ffffff;stroke-width:50;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;stroke-dasharray:none;stroke-opacity:1"
+         d="m 2291.31,1048.58 c 0,-312.932 -253.68,-566.611 -566.61,-566.611 -312.93,0 -566.62,253.679 -566.62,566.611 0,312.93 253.69,566.61 566.62,566.61 312.93,0 566.61,-253.68 566.61,-566.61 z" /><path
+         style="fill:#59b734;fill-opacity:1;fill-rule:nonzero;stroke:none"
+         d="m 1636.53,3156.59 c 0,-208.63 -169.12,-377.75 -377.74,-377.75 -208.63,0 -377.747,169.12 -377.747,377.75 0,208.62 169.117,377.74 377.747,377.74 208.62,0 377.74,-169.12 377.74,-377.74" /><path
+         style="fill:none;stroke:#ffffff;stroke-width:50;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;stroke-dasharray:none;stroke-opacity:1"
+         d="m 1636.53,3156.59 c 0,-208.63 -169.12,-377.75 -377.74,-377.75 -208.63,0 -377.747,169.12 -377.747,377.75 0,208.62 169.117,377.74 377.747,377.74 208.62,0 377.74,-169.12 377.74,-377.74 z" /></g></g>
+</svg>
\ No newline at end of file
diff --git a/hop-user-manual/modules/ROOT/assets/images/icons/plugin.svg b/hop-user-manual/modules/ROOT/assets/images/icons/plugin.svg
new file mode 100644
index 0000000..9aa8914
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/assets/images/icons/plugin.svg
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   viewBox="0 0 24 24"
+   height="24"
+   width="24"
+   version="1.1">
+  <path
+     style="fill:#0e3a5a;fill-opacity:1;stroke-width:1.18924"
+     d="m 24.023809,13.696428 c 0,2.074287 -1.559999,3.795 -3.6,4.077858 v 3.582857 a 2.4,2.3571429 0 0 1 -2.4,2.357143 H 13.46381 v -0.353571 a 3.24,3.1821429 0 0 0 -3.240001,-3.182144 c -1.7999994,0 -3.2399995,1.426072 -3.2399995,3.182144 v 0.353571 h -4.56 A 2.4,2.3571429 0 0 1 0.02380952,21.357143 v -4.478572 h 0.36000001 c 1.78799997,0 3.24000007,-1.414285 3.24000007,-3.182143 0,-1.767857 -1.4520001,-3.182142 -3.24000007,-3.182142 H 0.02380952 V 6.0357143 A 2.4,2.3571429 0 0 1 2.423 [...]
+  <path
+     d="m 2.4380952,20.111112 v -1.231999 l 0.407143,-0.196497 C 4.0445232,18.10381 4.9390137,17.217181 5.4981112,16.053062 6.336834,14.306721 6.1764493,12.212807 5.0811732,10.609694 4.5170068,9.7839463 3.7634164,9.1444673 2.8309523,8.7002104 L 2.4380952,8.5130399 V 7.2813924 6.049745 h 3.0000001 3 V 5.0580602 c 0,-0.8951381 0.00548,-1.0127491 0.056343,-1.2080493 0.2455349,-0.9428891 1.2122282,-1.5174117 2.1548137,-1.2806436 0.649911,0.1632508 1.13771,0.6423393 1.303929,1.2806436 0.05085 [...]
+     style="fill:#c9e8fb;fill-opacity:0.811765;stroke:#0e3a5a;stroke-width:0.340118;stroke-linecap:round;stroke-linejoin:round" />
+</svg>
diff --git a/hop-user-manual/modules/ROOT/assets/images/icons/search.svg b/hop-user-manual/modules/ROOT/assets/images/icons/search.svg
new file mode 100644
index 0000000..e4fa704
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/assets/images/icons/search.svg
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 18.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg
+    xmlns="http://www.w3.org/2000/svg"
+    enable-background="new 0 0 16 16"
+    viewBox="0 0 16 16"
+    y="0px"
+    x="0px"
+    height="16px"
+    width="16px"
+    version="1.1">
+<path fill="#0E3A5A" d="M12,10.2c0.7-1.1,1.1-2.3,1.1-3.6c0-3.6-2.9-6.5-6.5-6.5C3,0.1,0.1,3,0.1,6.6s2.9,6.5,6.5,6.5
+	c1.3,0,2.6-0.4,3.6-1.1l3.9,3.9l1.8-1.8L12,10.2z M11.1,6.6c0,2.5-2,4.5-4.5,4.5c-2.5,0-4.5-2-4.5-4.5s2-4.5,4.5-4.5
+	C9.1,2.1,11.1,4.1,11.1,6.6z"/>
+</svg>
diff --git a/hop-user-manual/modules/ROOT/nav.adoc b/hop-user-manual/modules/ROOT/nav.adoc
index f5982c2..d96eae8 100644
--- a/hop-user-manual/modules/ROOT/nav.adoc
+++ b/hop-user-manual/modules/ROOT/nav.adoc
@@ -9,7 +9,7 @@
 ** xref:getting-started/hop-next-steps.adoc[Next Steps]
 * xref:concepts.adoc[Concepts]
 * xref:hop-gui/index.adoc[Hop Gui]
-** xref:hop-gui/file-dialog.adoc[File Browser]
+** xref:hop-gui/file-dialog.adoc[File Dialog]
 ** xref:hop-gui/perspectives.adoc[Perspectives]
 ** xref:hop-gui/shortcuts.adoc[Keyboard Shortcuts]
 * xref:projects/index.adoc[Projects]
@@ -359,3 +359,4 @@
 ** xref:technology/google/google-info.adoc[Google]
 * xref:hop-tools/index.adoc[Hop Tools]
 ** xref:hop-tools/hop-conf/hop-conf.adoc[hop-conf]
+** xref:hop-tools/hop-search.adoc[hop-search]
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/hop-gui-git.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/hop-gui-git.adoc
new file mode 100644
index 0000000..6638c25
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/hop-gui-git.adoc
@@ -0,0 +1,3 @@
+= Working with git
+
+Coming soon
\ No newline at end of file
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-data-orchestration.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-data-orchestration.adoc
new file mode 100644
index 0000000..5ceb3dd
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-data-orchestration.adoc
@@ -0,0 +1,8 @@
+:imagesdir: ../assets/images
+
+== Data Orchestration Perspective
+
+Icon: image:icons/data_orch.svg[width="24px"]
+
+Description::
+The Data Orchestration perspective is where you'll spend most of your time in Hop Gui. This is where xref:pipeline/pipelines.adoc[pipelines] and xref:workflow/workflows.adoc[workflows] are built, tested and run.
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-file-explorer.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-file-explorer.adoc
new file mode 100644
index 0000000..f2fd4e5
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-file-explorer.adoc
@@ -0,0 +1,11 @@
+:imagesdir: ../assets/images
+
+== File Explorer Perspective
+
+Icon: image:icons/folder.svg[width="24px"]
+
+Description::
+The file explorer perspective is where you'll perform a lot of your file operation. This perspective contains handlers for the most common file types known to Hop. These are obviously hwf (workflows) and hpl (pipelines), but also JSON, CSV, TXT, XML, Markdown, SVG, Log and SAS 7 BDAT files. The File Explorer perspective is also where you'll manage version control for your projects through xref:hop-gui/hop-gui-git.adoc[Git integration].
+
+TIP: Even though fully functional, the editor for most file types in the File Explorer is rather basic. Expect these to evolve in the next Hop releases, or check the http://hop.apache.org/community/contribution-guides/code-contribution-guide/[code contribution guide] if you'd like to help us improve Hop by contributing file editors.
+
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-metadata.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-metadata.adoc
new file mode 100644
index 0000000..c2a8e3a
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-metadata.adoc
@@ -0,0 +1,8 @@
+:imagesdir: ../assets/images
+
+== Metadata Perspective
+
+Icon: image:icons/metadata.svg[width="24px"]
+
+Description::
+The Metadata perspective is where you manage the different xref:metadata-types/index.adoc[metadata types] available in your Hop projects.
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-neo4.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-neo4.adoc
new file mode 100644
index 0000000..6ac47ca
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-neo4.adoc
@@ -0,0 +1,14 @@
+:imagesdir: ../assets/images
+
+== Neo4j Perspective
+
+Icon: image:icons/neo4j_logo.svg[width="24px"]
+
+Description::
+The Neo4j perspective provides a view on and allows you to query Hop execution history from a Neo4j database.
+
+The perspective shows the value the `NEO4J_LOGGING_CONNECTION` (used to load execution logging to Neo4j), allows to select a workflow or pipeline to display logging for (optionally, specify the number of executions and only show root executions).
+
+For the selected workflow or pipeline, or all executions if none selected), the id, name, type, number of rows read, written, input, output and rejected, the number of error rows and the execution date and duration are shown.
+
+In the bottom half of the perspective dialog, the logging text, path to errors and a number of useful cypher queries are shown.
\ No newline at end of file
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-plugin.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-plugin.adoc
new file mode 100644
index 0000000..577bfa0
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-plugin.adoc
@@ -0,0 +1,8 @@
+:imagesdir: ../assets/images
+
+== Plugin Perspective
+
+Icon: image:icons/plugin.svg[width="24px"]
+
+Description::
+The plugin perspective gives you an overview of all the available plugins in your Hop installation. This includes a dropdown to filter by plugin type (top), and a table showing the plugin type, id, name, description and image file (icon).
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-search.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-search.adoc
new file mode 100644
index 0000000..a37e7ee
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/perspective-search.adoc
@@ -0,0 +1,14 @@
+:imagesdir: ../assets/images
+
+== Search Perspective
+
+Icon: image:icons/search.svg[width="24px"]
+
+Description::
+The Search perspective allows you to search through all metadata in your Hop projects. This not only includes workflows and actions, pipelines and transforms, but any other metadata type known to Hop.
+
+The search options are the location (all objects in Hop Gui or only the current project), and whether the search string is case sensitive (default: case insensitive) or the search string is a regular expression (default: false).
+
+The result table shows the type, name, filename, location, matching text and description. Use the 'Open' button at the bottom of the perspective to jump directly to the selected metadata object (e.g. open a transform in a pipeline).
+
+TIP: The xref:hop-tools/hop-search.adoc[hop-search] tool provides the same functionality as the Search Perspective through the command line instead of in a GUI.
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/perspectives.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/perspectives.adoc
index a13e074..6de4336 100644
--- a/hop-user-manual/modules/ROOT/pages/hop-gui/perspectives.adoc
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/perspectives.adoc
@@ -1,3 +1,19 @@
 = Hop Gui Perspectives
+:imagesdir: ../assets/images
 
-coming soon
\ No newline at end of file
+Hop comes with a number of perspectives built in.
+
+Change the current perspectives by clicking on the icon in the left hand toolbar, or through the corresponding keyboard shortcut.
+Use the keyboard shortcuts `CTRL-SHIFT-arrow-up` and `CTRL-SHIFT-arrow-down` to cycle through perspectives.
+
+include::perspective-data-orchestration.adoc[]
+
+include::perspective-metadata.adoc[]
+
+include::perspective-file-explorer.adoc[]
+
+include::perspective-search.adoc[]
+
+include::perspective-plugin.adoc[]
+
+include::perspective-neo4.adoc[]
\ No newline at end of file
diff --git a/hop-user-manual/modules/ROOT/pages/hop-gui/shortcuts.adoc b/hop-user-manual/modules/ROOT/pages/hop-gui/shortcuts.adoc
index ff3d10f..209ad0a 100644
--- a/hop-user-manual/modules/ROOT/pages/hop-gui/shortcuts.adoc
+++ b/hop-user-manual/modules/ROOT/pages/hop-gui/shortcuts.adoc
@@ -47,3 +47,18 @@ NOTE: If you are a Mac user, please be aware that the Mac keys must be used. Mos
 |Ctrl + -|Zoom out on your canvas
 |Ctrl + 0|Reset the zoom percentage to 100%
 |===
+
+
+== Perspective Shortcuts
+[width="85%", cols="30%, 70%", options="header"]
+|===
+|Shortcut|Action
+|CTRL + Shift + &uarr; | Switch one perspective up
+|CTRL + Shift + &darr; |Switch one perspective down
+|CTRL + Shift + d |Open the Data Orchestration Perspective
+|CTRL + Shift + m |Open the Metadata Perspective
+|CTRL + Shift + e |Open the File Explorer Perspective
+|CTRL + f |Open the Search Perspective
+|none|Open the Plugin Perspective
+|none|Open the Neo4j Perspective
+|===
diff --git a/hop-user-manual/modules/ROOT/pages/hop-tools/hop-search.adoc b/hop-user-manual/modules/ROOT/pages/hop-tools/hop-search.adoc
new file mode 100644
index 0000000..4ef9904
--- /dev/null
+++ b/hop-user-manual/modules/ROOT/pages/hop-tools/hop-search.adoc
@@ -0,0 +1,3 @@
+= Hop Search
+
+coming soon
diff --git a/hop-user-manual/modules/ROOT/pages/hop-tools/index.adoc b/hop-user-manual/modules/ROOT/pages/hop-tools/index.adoc
index 21a9f63..8563115 100644
--- a/hop-user-manual/modules/ROOT/pages/hop-tools/index.adoc
+++ b/hop-user-manual/modules/ROOT/pages/hop-tools/index.adoc
@@ -8,6 +8,6 @@ This page provides an overview of the tools that are available in the platform.
 * Hop Encrypt
 * Hop Gui
 * Hop Run
-* Hop Search
+* xref:hop-tools/hop-search.adoc[Hop Search]
 * Hop Server
 * Hop Translator
\ No newline at end of file
diff --git a/hop-user-manual/modules/ROOT/pages/password/passwords.adoc b/hop-user-manual/modules/ROOT/pages/password/passwords.adoc
index 1c94199..d8f0d3c 100644
--- a/hop-user-manual/modules/ROOT/pages/password/passwords.adoc
+++ b/hop-user-manual/modules/ROOT/pages/password/passwords.adoc
@@ -1,2 +1,8 @@
 [[password-plugins]]
 = Password Plugins
+
+Password handling  in Hop can be implemented as plugins.
+
+The following plugin implementations are available:
+
+* xref:password/passwords/aespasswords.adoc[AES Two Way Password Encoder]
\ No newline at end of file
diff --git a/hop-user-manual/modules/ROOT/pages/plugins/plugins.adoc b/hop-user-manual/modules/ROOT/pages/plugins/plugins.adoc
index efc77e5..1984c6f 100644
--- a/hop-user-manual/modules/ROOT/pages/plugins/plugins.adoc
+++ b/hop-user-manual/modules/ROOT/pages/plugins/plugins.adoc
@@ -11,26 +11,30 @@ This plugin organization is mainly technical, there is no 1 on 1 mapping between
 
 * xref:workflow/actions.adoc[Action Plugins]
 * xref:database/databases.adoc[Database Plugins]
-* Engines
-** Apache Beam (Spark, Flink and Google Dataflow run configurations over Apache Beam)
+* Engines: the xref:pipeline/pipeline-run-configurations/beam-spark-pipeline-engine.adoc[Apache Spark], xref:pipeline/pipeline-run-configurations/beam-flink-pipeline-engine.adoc[Apache Flink] and xref:pipeline/pipeline-run-configurations/beam-dataflow-pipeline-engine.adoc[Google Dataflow] run configurations are plugins that run through https://beam.apache.org[Apache Beam]
 * Miscellaneous Plugins
 ** Debug
-** Git
+** xref:hop-gui/hop-gui-git.adoc[Git]
 ** Import
-** Passwords
+** xref:password/passwords.adoc[Passwords]
 ** xref:projects/index.adoc[Projects]
 ** Reflection
 ** Testing
 * Tech
-** Azure
-** Cassandra
-** Google
-** Neo4j
+** Azure: a collection of plugins for Azure, including xref:vfs/azure-blob-storage-vfs.adoc[VFS Blob Storage], xref:pipeline/transforms/azure-event-hubs-listener.adoc[Azure Hubs Listener] and xref:pipeline/transforms/azure-event-hubs-writer.adoc[Azure Hubs Writer]
+** Cassandra: xref:metadata-types/cassandra/cassandra-connection.adoc[Cassandra Connection], xref:pipeline/transforms/cassandra-input.adoc[Cassandra Input] and xref:pipeline/transforms/cassandra-output.adoc[Cassandra Output]
+** Google:
+*** VFS: xref:vfs/google-cloud-storage-vfs.adoc[Google Cloud Storage], xref:vfs/google-drive-vfs.adoc[Google Drive]
+*** Transforms: xref:pipeline/transforms/google-sheets-input.adoc[Google Sheets Input], xref:pipeline/transforms/google-sheets-input.adoc[Google Sheets Output], Google Analytics
+** Neo4j: a collection of Neo4j plugins
 * xref:pipeline/transforms.adoc[Transform Plugins]
 * Value Types
 ** JSON
 * VFS
-** S3
+** xref:vfs/aws-s3-vfs.adoc[AWS S3]
+** xref:vfs/azure-blob-storage-vfs.adoc[Azure Blob Storage],
+** xref:vfs/google-cloud-storage-vfs.adoc[Google Cloud Storage], xref:vfs/google-drive-vfs.adoc[Google Drive]
+
 
 Each type is explained in their own section.
 
diff --git a/hop-user-manual/modules/ROOT/pages/samples/dummy-sample.adoc b/hop-user-manual/modules/ROOT/pages/samples/dummy-sample.adoc
index 7a03ccb..4eb0b32 100644
--- a/hop-user-manual/modules/ROOT/pages/samples/dummy-sample.adoc
+++ b/hop-user-manual/modules/ROOT/pages/samples/dummy-sample.adoc
@@ -1,5 +1,5 @@
 [[Samples-DummySample]]
 = Dummy sample
 
-Explenation of Dummy Sample
+Coming soon
 
diff --git a/hop-user-manual/modules/ROOT/pages/samples/samples.adoc b/hop-user-manual/modules/ROOT/pages/samples/samples.adoc
index c16f81f..1602115 100644
--- a/hop-user-manual/modules/ROOT/pages/samples/samples.adoc
+++ b/hop-user-manual/modules/ROOT/pages/samples/samples.adoc
@@ -1,5 +1,5 @@
 [[Samples]]
 = Samples
 
-General info about the samples included in hop
+Coming soon.