Improve api keys

Author: ggiraldof

tutorial/api_keys.rst

@@ -1,14 +1,15 @@
-API Keys
-========
+API Key
+=======
 
 How to get an API Key
 ---------------------
 
-Your personal API Key is generated in the SimScale platform. Follow these steps:
+A SimScale API Key is tied to a platform account. In order to generate one for your account,
+please follow these steps:
 
 1. Sign in to the SimScale platform in `www.simscale.com <https://www.simscale.com/>`_
-2. Open account menu at the top left
-3. Go to 'Manage Account' or 'User Preferences', depending on wether you are in the Workbench
+2. Open the account menu by hovering over your user name at the top right
+3. Go to 'Manage Account' or 'User Preferences' on the menu, depending on wether you are in the SimScale Workbench or the website.
 4. Open the 'API Keys' tab
 5. Use the 'Generate Key' button
 6. Enter a description for this new key
@@ -24,7 +25,7 @@ If doing so, your ``.env`` file should contain a line such as:
 API Client
 ----------
 
-User authentication with the SimScale API is performed using the ``X-API-KEY`` request header.
+User authentication in the SimScale API is performed using the ``X-API-KEY`` request header.
 In your code, you must first initialize and configure a ``simscale_sdk.ApiClient`` object, which
 holds the data for the host, identification header and API Key. This object is later used to
 setup the different Api clients specific to each platform action.
@@ -57,7 +58,7 @@ The following snippet shows an example of the creation and setup of the ``ApiCli
 .. code-block:: csharp
     
     // C#
-    
+
     using System;
     using SimScale.Sdk.Api;
     using SimScale.Sdk.Client;