17421: Added page about migration to Workbench 2

Arvados-DCO-1.1-Signed-off-by: Peter Amstutz <peter.amstutz@curii.com>

diff --git a/doc/_config.yml b/doc/_config.yml
index f2ddd7f58c11a246accc2fec6c01c72d86d9a633..9dd7f40529ef6a9343cd834e710f728a488662f0 100644 (file)
--- a/doc/_config.yml
+++ b/doc/_config.yml
@@ -26,9 +26,10 @@ navbar:
       - user/getting_started/community.html.textile.liquid
     - Walkthough:
       - user/tutorials/wgs-tutorial.html.textile.liquid
       - user/getting_started/community.html.textile.liquid
     - Walkthough:
       - user/tutorials/wgs-tutorial.html.textile.liquid

-    - Run a workflow using Workbench:
+    - Using Workbench:

       - user/getting_started/workbench.html.textile.liquid
       - user/tutorials/tutorial-workflow-workbench.html.textile.liquid
       - user/getting_started/workbench.html.textile.liquid
       - user/tutorials/tutorial-workflow-workbench.html.textile.liquid

+      - user/topics/workbench-migration.html.textile.liquid

     - Working at the Command Line:
       - user/getting_started/setup-cli.html.textile.liquid
       - user/reference/api-tokens.html.textile.liquid
     - Working at the Command Line:
       - user/getting_started/setup-cli.html.textile.liquid
       - user/reference/api-tokens.html.textile.liquid

diff --git a/doc/images/switch-to-wb1.png b/doc/images/switch-to-wb1.png
new file mode 100644 (file)
index 0000000..3787e31
Binary files /dev/null and b/doc/images/switch-to-wb1.png differ

diff --git a/doc/images/switch-to-wb2.png b/doc/images/switch-to-wb2.png
new file mode 100644 (file)
index 0000000..177090b
Binary files /dev/null and b/doc/images/switch-to-wb2.png differ

diff --git a/doc/images/wb2-example.png b/doc/images/wb2-example.png
new file mode 100644 (file)
index 0000000..7bdea9e
Binary files /dev/null and b/doc/images/wb2-example.png differ

diff --git a/doc/user/getting_started/workbench.html.textile.liquid b/doc/user/getting_started/workbench.html.textile.liquid
index 644cf7d2086967b057309d37ae733c782114f724..7091e31eae78fb02dc6b357a1befdf6568d469dc 100644 (file)
--- a/doc/user/getting_started/workbench.html.textile.liquid
+++ b/doc/user/getting_started/workbench.html.textile.liquid
@@ -10,9 +10,7 @@ SPDX-License-Identifier: CC-BY-SA-3.0
 {% endcomment %}
 
 {% include 'notebox_begin' %}
 {% endcomment %}
 
 {% include 'notebox_begin' %}

-This guide covers the classic Arvados Workbench web application, sometimes referred to as "Workbench 1".  There is also a new Workbench web application under development called "Workbench 2".  Sites which have both Workbench applications installed will have a dropdown menu option "Switch to Workbench 2" to switch between versions.
-
-This guide will be updated to cover "Workbench 2" in the future.
+This guide covers the classic Arvados Workbench web application, sometimes referred to as "Workbench 1".  There is also a new Workbench web application under development called "Workbench 2".  This guide will be updated to cover "Workbench 2" in the future.  See "Workbench 2 migration":{{site.baseurl}}/user/topics/workbench-migration.html for more information.

 {% include 'notebox_end' %}
 
 You can access the Arvados Workbench used in this guide using this link:
 {% include 'notebox_end' %}
 
 You can access the Arvados Workbench used in this guide using this link:

diff --git a/doc/user/topics/workbench-migration.html.textile.liquid b/doc/user/topics/workbench-migration.html.textile.liquid
new file mode 100644 (file)
index 0000000..5cb1996
--- /dev/null
+++ b/doc/user/topics/workbench-migration.html.textile.liquid
@@ -0,0 +1,49 @@
+---
+layout: default
+navsection: userguide
+title: "Workbench 2 migration"
+...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
+
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
+
+Arvados is in the process of migrating from the classic web application, referred to as "Workbench 1", to a completely new web application, referred to as "Workbench 2".
+
+!{width: 90%}{{ site.baseurl }}/images/wb2-example.png!
+
+Workbench 2 is the new Workbench web application first introduced in Arvados 2.0.  Workbench 2 is built using modern web technologies and based on user feedback.  Workbench 2 has a modern look and feel and offers several advanced features and performance enhancements.  Arvados clusters which have both Workbench applications installed will have a dropdown menu option  “Go to Workbench 2” to switch between versions.
+
+!{{ site.baseurl }}/images/switch-to-wb2.png!
+
+Workbench 2 is stable and recommended for general use, but still lacks some features available in the classic Workbench 1 application.  When necessary, you can easily switch back:
+
+!{{ site.baseurl }}/images/switch-to-wb1.png!
+
+Some major improvements of Workbench 2 include:
+
+h2. General
+
+* More responsive, only loads data needed for display
+* More familiar user interface, modeled on the file explorer of MacOS and Windows.
+* Advanced search capabilities
+
+h2. Project browsing
+
+* Expanded informational columns
+* Expanded filtering options
+* Right side informational panel providing details about selected item without navigating away from the project
+* Support for adding and querying user-supplied metadata properties on Projects
+
+h2. Collection browsing
+
+* Able to browse collections with millions of files
+* Support for adding and querying user-supplied metadata properties on Collections
+* Support for viewing past versions of a collection
+
+h2. User and Group management
+
+* Able to create user groups through the GUI
+* Able to add/view/remove members of user groups, and what permissions are shared with the group
+* Able to add/view/remove permissions shared with individual users