docs: further pass on prereq section

Author: vburckhardt

Diff for: docs/prereqs.md

@@ -1,26 +1,41 @@
-# Lab Prerequisites :white_check_mark:
+# Lab Prerequisites ☑
 
 Make sure that you meet the following prerequisites before you begin the lab.
 
-- IBM Cloud
-    - An IBM Cloud Pay-Go or Subscription account
-    - An IBMid
+## IBM Cloud
 
-        :information_source: **Note**:  Participants in the TechXchange classroom will be provided with credentials to access an IBM Cloud account during the lab.
-    - [API key with the following permissions](https://cloud.ibm.com/docs/account?topic=account-userapikey&interface=ui#create_user_key)
+1.  An IBM Cloud Pay-Go or Subscription account (trial accounts are not sufficient)
 
-    | Service | Resources |  Role |
-    | -------- | ------- | ------- |
-    | IBM Cloud Projects | Aldministrator |
-    | Activity Tracker event routing | All | Editor |
-    | Transit Gateway | All | Editor, Manager |
-    | Schematics | All | Editor, Manager |
-    | Key Protect | All | Editor, KeyPurge, Manager |
-    | Cloud Object Storage | All | Editor, Manager |
-    | VPC Infrastructure Services | All | Editor, Manager |
-    | Resource group only | All resource group in the account | Viewer, Editor, Administrator|
+    :information_source: **Note**:  Participants in the TechXchange lab will be provided with user credentials to access a paid IBM Cloud account for the duration of the lab.
 
-     :exclamation: **Important**: Participants in the TechXchange classroom will need to create an API key for their provided credentials.  Please save the generated API key for later use.
+2. A personal API Key associated with a user with the following permissions.
+
+    :information_source: **Note**:  The user account provided in the TechXchange lab already has got the necessary permissions. Participants in the TechXchange lab only need to create an API Key as described below.
+
+
+| Service | Resources |  Role |
+| -------- | ------- | ------- |
+| IBM Cloud Projects | All | Administrator |
+| Activity Tracker event routing | All | Editor |
+| Transit Gateway | All | Editor, Manager |
+| Schematics | All | Editor, Manager |
+| Key Protect | All | Editor, KeyPurge, Manager |
+| Cloud Object Storage | All | Editor, Manager |
+| VPC Infrastructure Services | All | Editor, Manager |
+| Resource group only | All resource group in the account | Viewer, Editor, Administrator|
+| Catalog Management | All | Editor, Publisher|
+
+
+To create an API Key: \
+    1. In the IBM Cloud console, go to **Manage > Access (IAM) > API keys.** \
+    2. Click **Create an IBM Cloud API key**. \
+    3. Enter a name and description for your API key. \
+    4. Click **Create** \
+    5. Then, click **Show** to display the API key.
+
+:exclamation: **Important**: Please save the generated API key for later use in the labs. The API key is only available to be copied or downloaded at the time of creation. If the API key is lost, you can re-create a new API key.
+
+## Development environment
 
 - A development computer with the following software.
     - [Terraform](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli)
@@ -33,4 +48,4 @@ Make sure that you meet the following prerequisites before you begin the lab.
         For more information, see [Generating an external SSH key](https://cloud.ibm.com/docs/vpc?topic=vpc-ssh-keys&interface=ui#generating-ssh-keys).
     - Optional: [IBM Cloud CLI](https://cloud.ibm.com/docs/cli?topic=cli-getting-started)
 
-:information_source: **Note**:  Participants in the TechXchange classroom will be provided with a development VM with the prerequisite software installed.
+:information_source: **Note**:  Participants in the TechXchange classroom will be provided with a development VM with the prerequisite software installed. You may however decide to use your own machine for convenience.

Diff for: docs/sidebar.md

@@ -3,7 +3,7 @@
   - [🌍 VPC Landing Zone](./about/20-vpc-landing-zone.md)
   - [🏗️ Deployable architectures](./about/30-deployable-arch)
   - [📚 IBM Cloud projects](./about/40-projects.md)
-- [📂 Lab Prerequisites](./prereqs.md)
+- [☑ Lab Prerequisites](./prereqs.md)
 - [📂 Lab 1 - End-to-end deployment](./part1/00-objectives.md)
   - [🚀 Deploy the landing zone VSI pattern](./part1/10-project.md)
   - [👤 Operator Access](./part1/20-operator-access.md)