Update readme.md

gitlab/readme.md

@@ -1,35 +1,42 @@
-# Valet labs for GitLab
+# GitLab to Actions migrations powered by Valet
+The instructions below will guide you through configuring a GitHub Codespace environment that will be used in subsequent labs that demonstrate how to use Valet to migrate GitLab pipelines to GitHub Actions.
 
-This lab bootstraps a Valet environment using GitHub Codespaces and enables you to run the Valet CI/CD migration tool against an isolated GitLab instance running in Docker. 
+These steps **must** be completed prior to starting other labs.
 
-- [Prerequisites](#prerequisites)
+## Create your own repository for these labs
-- [Setup Codespace for Labs](#setup-codespace-for-labs)
+1. Ensure that you have created a repository using the [valet-customers/labs](https://github.com/valet-customers/labs) as a template.
-- [Labs for GitLab](#labs-for-gitlab)
 
-
+## Configure your Codespace
-## Prerequisites
-1. [Valet Labs](https://github.com/valet-customers/labs) template has been used to generate this repository.
-
-## Setup Codespace for Labs
 
 1. Start the codespace
+
 - Click the `Code` button down arrow above the repository on the repository's landing page.
 - Click the `Codespaces` tab.
-    - Click `Create codespaces on main` to create the codespace. If you are in another branch then the `main` branch, the codespace button will have the current branch specified.
+- Click `Create codespaces on main` to create the codespace.
-    - Wait a couple minutes, then verify that the codespace starts up. Once it is fully booted up, the terminal should be present.
+- After the Codespace has initialized there will be a terminal present.
-2. Verify Valet CLI is installed and working. More information on the [GitHub Valet CLI extension](https://github.com/github/gh-valet)
+
-    -  Run `gh valet version` in the codespace terminal and verify it returns results like below, actual versions will vary.
+2. Verify the Valet CLI is installed and working. More information on the Valet extension for the official GitHub CLI can be found [here](https://github.com/github/gh-valet).
+
+- Run the following command in the codespace's terminal:
+
+```bash
+gh valet version
 ```
+
+- Verify the output is similar to below, if not try manually installing the valet extension, using the [troubleshooting](#troubleshooting) section.
+
+```bash
 gh version 2.14.3 (2022-07-26)
 gh valet        github/gh-valet v0.1.12
 valet-cli       unknown
 ```
-    if results do not match try manually installing the valet extension, using the [troubleshooting](#troubleshooting) section.
 
 3. Run the GitLab setup script.  This script will set up GitLab and ensure it is ready to use.  In general, this script should be run first if you are starting a new codespace or restarting an existing one.  
+
 -  from the codespace terminal run `source gitlab/bootstrap/setup.sh`.
 
 4. Verify you can login to the GitLab Server.
+
 - Click the `PORTS` tab in the codespace terminal window.
 - In the row that starts with `80` mouse over the address under the column heading `Local Address`, and click the globe icon.
 - Verify a new browser tab opened to the GitLab login screen.