Clients: document web usage

approved
(Baptiste Grenier) #1
Clients: document web usage
diff --git a/source/_static/datahub-browse-space.png b/source/_static/datahub-browse-space.png
new file mode 100644
index 0000000..9f40d3d
Binary files /dev/null and b/source/_static/datahub-browse-space.png differ
diff --git a/source/_static/datahub-connect-check-in.png b/source/_static/datahub-connect-check-in.png
new file mode 100644
index 0000000..ec764dc
Binary files /dev/null and b/source/_static/datahub-connect-check-in.png differ
diff --git a/source/_static/datahub-space-info.png b/source/_static/datahub-space-info.png
new file mode 100644
index 0000000..84e1740
Binary files /dev/null and b/source/_static/datahub-space-info.png differ
diff --git a/source/_static/datahub-welcome-screen.png b/source/_static/datahub-welcome-screen.png
new file mode 100644
index 0000000..44ad8de
Binary files /dev/null and b/source/_static/datahub-welcome-screen.png differ
diff --git a/source/clients.rst b/source/clients.rst
index f1177dd..5c0bc07 100644
--- a/source/clients.rst
+++ b/source/clients.rst
@@ -3,22 +3,76 @@
 Clients
 -------
 
-Testing Oneclient in a Vagrant box
-`‍```‍```‍```‍```‍```‍```‍```‍```‍```‍```‍```
+Using the web interface
+^^^^^^^^^^^^^^^^^^^^^^^
 
-It's possible to quickly test Oneclient using `Vagrant <https://www.vagrantup.com/>`_.
+.. figure:: _static/datahub-connect-check-in.png
+   :alt: EGI DataHub connection with Check-in
+
+   Selecting EGI to connect using EGI Check-in
+
+   Using EGI Check-in it's possible to connect with its institute credentials.
+
+.. image:: _static/datahub-welcome-screen.png
+   :alt: EGI DataHub landing page
+
+   EGI DataHub landing page
+
+   On this page it's possible to have an overview of all the spaces and their
+   supporting providers.
+
+.. image:: _static/datahub-space-info.png
+   :alt: EGI DataHub spaces information
+
+   Information about spaces supported by a Oneprovider
+
+   On this capture, the information about the spaces supported
+   by a specific provider is displayed.
+
+.. image:: _static/datahub-browse-space.png
+   :alt: EGI DataHub browsing a space
+
+   Information about spaces supported by a Oneprovider
+
+   The data space can be managed (ie. uploading/downloading/managing files and
+   metadata, manging space access) using the web browser.
+
+
+Generating tokens for using Oneclient or APIs
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 In order to be able to access your spaces using `Oneclient` or `APIs`, it's
 required to generate an access token.
 
 Tokens have to be generated from the `DataHub` (Onezone) interface.
 
+.. image:: _static/datahub-space-token.png
+
+Testing Oneclient in a Virtual Machine
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 The following variables have to be exported:
 
 * `ONECLIENT_ACCESS_TOKEN`: access token allowing to access **all** the spaces.
 * `ONECLIENT_PROVIDER_HOST`: name or IP of the Oneprovider the client should connect to.
 
-.. image:: _static/datahub-space-token.png
+.. code-block:: console
+
+   curl -sS http://get.onedata.org/oneclient.sh | bash
+   export ONECLIENT_ACCESS_TOKEN=<ACCESS_TOKEN_FROM>
+   export ONECLIENT_PROVIDER_HOST=plg-cyfronet-01.datahub.egi.eu
+   mkdir /tmp/space
+   oneclient /tmp/space
+
+Testing Oneclient in a Vagrant box
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+It's possible to quickly test Oneclient using `Vagrant <https://www.vagrantup.com/>`_.
+
+The following variables have to be exported:
+
+* `ONECLIENT_ACCESS_TOKEN`: access token allowing to access **all** the spaces.
+* `ONECLIENT_PROVIDER_HOST`: name or IP of the Oneprovider the client should connect to.
 
 .. code-block:: console

GitHub sha: 99198ad0

(Bruce Becker) Approved #2