Traning Notebooks (#683)

<!--
A good PR should describe what benefit this brings to the repository.
This description of the PR will be used as the commit message when
merging it.
Ideally, there is an existing issue which the PR address.

Please check the [Contributing
guide](https://docs.egi.eu/about/contributing/)
for style requirements and advice.
-->

# Summary

Remove the training section of Notebooks and turned it into a Quick
Start section.

<!-- Describe in plain English what this PR does. -->

---

<!-- Add, if any, the related issue here, e.g. #6 -->

**Related issue :**

---------

Co-authored-by: Baptiste Grenier <[email protected]>

.github/linters/mlc_config.json

@@ -38,9 +38,6 @@
     {
       "pattern": "^http://cvmfs-release01.gridpp.rl.ac.uk/*"
     },
-    {
-      "pattern": "^https://training.notebooks.egi.eu*"
-    },
     {
       "pattern": "^https://goc.egi.eu/portal*"
     },

content/en/users/dev-env/notebooks/_index.md

@@ -30,7 +30,7 @@ EGI Notebooks provides the well-known Jupyter interface for notebooks, with the
 following added features:
 
 - Integration with [EGI Check-in](../../aai/check-in/) allows you to login with
-  any EduGAIN or social accounts (e.g. Google, Facebook)
+  any eduGAIN or social accounts (e.g. Google, Facebook)
 - Persistent storage associated with each user is available in the notebooks
   environment
 - Customisable with new notebook environments, expose any existing notebook to
@@ -86,3 +86,13 @@ EGI currently operates community instances for:
   [EOSC-Pillar](https://eosc-pillar.d4science.org/). Check with
   [D4Science support](https://www.d4science.org/contact-us) for more
   information.
+
+### Training instance
+
+EGI can provide a custom and temporary instance of the Notebooks service for
+training events, if you have a specific event where you would like to use EGI
+Notebooks as platform for your training, [let us know](../../../support/).
+
+{{% alert title="Note" color="warning" %}}This instance may not use the same
+software version as in production and may not be always available, as it is
+typically configured only for specific training events. {{% /alert %}}

content/en/users/dev-env/notebooks/training/_index.md → content/en/users/dev-env/notebooks/quickstart/_index.md

@@ -1,48 +1,58 @@
 ---
-title: Notebooks Training Instance
-title: Training Instance
-weight: 30
+title: Notebooks Quick Start
+weight: 1
 type: docs
 aliases:
   - /users/notebooks/training
 description: >
-  Notebooks for training events
+  Getting started with EGI Notebooks
 ---
 
-EGI provides a training instance of the Notebooks service for training events.
+The Notebooks Service is based on [JupyterHub](https://jupyter.org/hub). It
+enables remote use of [Jupyter Notebooks](https://jupyter.org/) in a managed
+environment integrated with other EGI services. Notebooks main interface uses
+[JupyterLab](https://jupyterlab.readthedocs.io), a highly extensible environment
+for running and authoring computational notebooks.
 
-To get started:
+You can find links below to the upstream documentation of the EGI Notebooks
+components:
 
-1. Go to <https://training.notebooks.egi.eu>.
+- [JupyterLab Documentation](https://jupyterlab.readthedocs.io) for use of the
+  integrated user environment (menus, working tabs, etc.)
+- [JupyterHub Documentation](https://jupyterhub.readthedocs.io/en/latest/) to
+  manage your remote resources (starting and stopping servers, collaborative
+  sharing, etc.)
+- Documentation for your core programming languages:
+  - [Python](https://docs.python.org/)
+  - [Julia](https://docs.julialang.org/)
+  - [R](https://cran.r-project.org/doc/manuals/r-release/R-intro.html)
+  - [Octave](https://docs.octave.org/latest/)
 
-   {{% alert title="Note" color="warning" %}} This instance may not use the same
-   software version as in production and may not be always available, as it is
-   typically configured only for specific training events. {{% /alert %}}
+## Getting Started
 
-1. Start the authentication process by clicking on **Start your notebooks!**
-   button
+1. Start by [creating an EGI account](../../../aai/check-in/signup)
+1. Then enroll
+   [vo.notebooks.egi.eu VO](https://aai.egi.eu/registry/co_petitions/start/coef:111)
+1. Go to [https://notebooks.egi.eu/](https://notebooks.egi.eu/)
+1. Start the authentication process by clicking on **Continue with EGI
+   Check-in!** button
 
-   ![image](training-front.png)
+   ![Notebooks welcome page](notebooks-front.png)
 
-1. Select the Identity Provider you belong to from the discovery page. If this
-   is the first time you access an EGI service, Check-in will guide you through
-   a registration process.
+1. Once logged in, you will prompted to select the [environment](../kernels/),
+   pick the "Default EGI environment"
+1. Click on "Start" to get your JupyterLab instance You will see the Jupyter
+   interface once your personal server is started
 
-   ![Check-in auth](checkin.png)
-
-1. You will see the Jupyter interface once your personal server is started
-
-   ![Classic Jupyter Notebook](classic.png)
+   ![JupyterLab](lab.png)
 
 ## Launching a notebook
 
-Click on the New \> Python 3 option to launch your notebook with Python 3
+Click on the "Python 3 (ipykernel)" option to launch your notebook with Python 3
 kernel. When you create this notebook, a new tab will be presented with a
 notebook named `Untitled.ipynb`. You can easily rename it by right-clicking on
 the current name.
 
-![New notebook](new-classic.png)
-
 ### Structure of a notebook
 
 The notebook consists of a sequence of cells. A cell is a multiline text input
@@ -104,14 +114,13 @@ most common:
   using keyboard shortcuts.
 - `Enter` : Edit mode. In edit mode, you can edit text in cells.
 
-## Hands-on
+## Tutorials
 
-We pre-populate your home directory with some sample notebooks to get started,
-below you can find links to other notebooks that we have used in past trainings
-that may be useful to explore the system:
+You can find links to sample notebooks that we have used in past trainings that
+may be useful to explore the system:
 
 1. [A very basic notebook to get started](https://github.com/EGI-Federation/training-notebooks-di4r-2018/blob/master/00-first-notebook.ipynb)
-2. [Getting data and doing a simple plot](https://github.com/EGI-Federation/training-notebooks-climate-change/blob/master/cckp_historical_temperature.ipynb).
-3. [Connect to NOAA\'s GrADS Data Server to plot wind speed](https://github.com/EGI-Federation/training-notebooks-di4r-2018/blob/master/02-wind-nowcast.ipynb).
-4. [Installing new libraries](https://github.com/EGI-Federation/training-notebooks-di4r-2018/blob/master/03-customizing.ipynb).
-5. [Interact with Check-in](https://github.com/EGI-Federation/training-notebooks-di4r-2018/blob/master/04-check-in.ipynb)
+1. [Getting data and doing a simple plot](https://github.com/EGI-Federation/training-notebooks-climate-change/blob/master/cckp_historical_temperature.ipynb).
+1. [Connect to NOAA\'s GrADS Data Server to plot wind speed](https://github.com/EGI-Federation/training-notebooks-di4r-2018/blob/master/02-wind-nowcast.ipynb).
+1. [Installing new libraries](https://github.com/EGI-Federation/training-notebooks-di4r-2018/blob/master/03-customizing.ipynb).
+1. [Interact with Check-in](https://github.com/EGI-Federation/training-notebooks-di4r-2018/blob/master/04-check-in.ipynb)