Rewords ops setup instructions.

ops-setup/1-network.md

@@ -1,11 +1,12 @@
 # Ops Setup
 
-## Network Connectivity
+Your first step is ensure that your lab PC is connected to the internet, so you can update the operating system.
 
-First, check that your lab PC is connected to your home network via ethernet or Wi-Fi. Then, use the Ubuntu desktop GUI to update the Ubuntu OS to the latest version.
+## OS Updates
 
-- On the back of the lab kit PC, on its I/O shield, you'll find the ethernet port. If you need an ethernet cable, check the packaging for your SOHO router and use the included cable. Plug the cable into the back of the PC and run it to your home router/modem.
-- Alternatively, try the included wi-fi adapter (antenna with USB).
+Verify that your lab PC is connected to the internet via ethernet or Wi-Fi. Opening a web browser on your PC should let you access usual web pages.
+
+Then, use the Ubuntu desktop GUI to update the OS to the latest version. This may take some time, depending on what updates are available. 
 
 ---
 

ops-setup/2-update.md

@@ -1,15 +1,18 @@
 # Ops Setup
 
-## Update Linux
+Now, let's get your system configured for remote access.
 
-- Log in to Ubuntu Linux Desktop and open a Terminal session.
-- Search for "Terminal" in the menu system and be sure to favorite this app.
-- Run `sudo apt update` to update your Apt package manager.
-  - **NOTE: Always run this command before installing a new software package from Apt.**
-- Run `sudo apt install xrdp -y`, which installs a software package that will allow you to connect to this lab kit PC remotely in subsequent classes.
+## Update Packages
+
+1. Log in to Ubuntu Linux Desktop and open a Terminal session.
+   - To do this, search for "Terminal" in the menu system. 
+   - Be sure to favorite this app for easy access in the future.
+1. Run `sudo apt update` in the terminal to update your Apt package manager.
+  - **Always run this command before installing a new software package from Apt.**
+1. Run `sudo apt install xrdp -y`, which installs a software package that will allow you to connect to this lab kit PC remotely in subsequent classes.
   - The `-y` option bypasses an "Are you sure?" prompt.
-- Allow the RDP server to initialize on startup with `sudo systemctl enable --now xrdp`.
-  - You'll need this in a later class.
+1. Allow the RDP server to initialize on startup. Run `sudo systemctl enable --now xrdp` in the terminal.
+  - This ensures when you reboot, you'll still be able to connect remotely.
 
 ---
 

ops-setup/3-ip.md

@@ -1,9 +1,11 @@
 # Ops Setup
 
-## Get Internet Pprotocol (IP) Address
+Keep track of your IP address. 
+
+## Get Your Internet Protocol (IP) Address
 
 - Check your IP address with `ip a` and write it down/take note somewhere.
-- For a walkthrough on how this works, click here: [How ip a works](https://itsfoss.com/check-ip-address-ubuntu/)
+- Review this walkthrough on [how the ip command works](https://itsfoss.com/check-ip-address-ubuntu/){target: "_blank"}
 
 ---
 

ops-setup/4-git.md

@@ -1,15 +1,13 @@
 # Ops Setup
 
-## Git Installation
-
-- Run `sudo apt install git -y` to install Git.
-- Run `mkdir ~/github` to create a folder to store repositories.
-- Type `cd ~/github` to move there.
-  - This is how you can change terminal location in Linux shell.
+You'll use the `git` command for managing the Ops scripts you write. Let's set it up now.
 
-## Download file to be used later
+## Git Installation
 
-- Run `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf`
+1. Run `sudo apt install git -y` in the terminal to install Git.
+1. Run `mkdir ~/github` to create a folder to store repositories.
+1. Run `cd ~/github` to move there.
+   - This is how you can change the "current folder" you are working in, from within the Linux shell.
 
 ---
 

ops-setup/5-virtualbox.md

@@ -1,27 +1,37 @@
 # Ops Setup
 
+Configure your lab PC as a host for virtual machines.
+
 ## Virtualbox
 
-### Download Virtalbox using latest .deb file - run these commands
+### Download Virtalbox
+
+Run each of these commands in your terminal:
+
+1. ```wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -```
+1. ```wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -```
+1. ```echo "deb [arch=amd64] http://download.virtualbox.org/virtualbox/debian eoan contrib" | sudo tee /etc/apt/sources.list.d/virtualbox.list```
+
+### Install Virtalbox using Apt 
+
+Run each of these commands in your terminal:
 
-  - ```wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -```
-  - ```wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -```
-  - ```echo "deb [arch=amd64] http://download.virtualbox.org/virtualbox/debian eoan contrib" | sudo tee /etc/apt/sources.list.d/virtualbox.list```
+1. ```sudo apt update```
+1. ```sudo apt install linux-headers-$(uname -r) dkms -y```
+1. ```sudo apt install virtualbox -y```
 
-### Install Virtalbox using Apt and pointing it to the downloaded .deb file - run these commands
+### Add the Virtualbox Extension Pack 6.1.16
 
-  - ```sudo apt update```
-  - ```sudo apt install linux-headers-$(uname -r) dkms -y```
-  - ```sudo apt-get install virtualbox -y```
+Run each of these commands in your terminal:
 
-### Download and install Virtualbox Extension Pack 6.1.16 - run these commands
+1. ```wget https://download.virtualbox.org/virtualbox/6.1.16/Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack```
+1. ```vboxmanage extpack install Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack --accept-license=33d7284dc4a0ece381196fda3cfe2ed0e1e8e7ed7f27b9a9ebc4ee22e24bd23c```
 
-  - ```wget https://download.virtualbox.org/virtualbox/6.1.16/Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack```
-  - ```vboxmanage extpack install Oracle_VM_VirtualBox_Extension_Pack-6.1.16-140961.vbox-extpack --accept-license=33d7284dc4a0ece381196fda3cfe2ed0e1e8e7ed7f27b9a9ebc4ee22e24bd23c```
+### Create a Shortcut to Virtualbox
 
-### Create a shortcut to Virtualbox  - run this command
+Run this command in your terminal to add a shortcut to your desktop:
 
-  - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'virtualbox.desktop']"```
+1. ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'virtualbox.desktop']"```
 
 ---
 

ops-setup/6-display.md

@@ -1,19 +1,28 @@
 # Ops Setup
 
-## Adjust some display settings
-- You may adjust these to your personal preference if you know how.
+Let's now configure some system settings.
 
-### Activate default dark mode (personal preference) - run this command
+### System Settings
 
-- ```gsettings set org.gnome.desktop.interface gtk-theme "Adwaita-dark"```
+1. Deactivate screen locking, as we mostly running this as a server box via RDP:
+   - `gsettings set org.gnome.desktop.screensaver lock-enabled false`
+1. If you prefer dark mode, activate it as the default:
+   - `gsettings set org.gnome.desktop.interface gtk-theme "Adwaita-dark`
+1. Adjust other display settings from the Settings app.
+   - You may adjust these to your personal preference if you know how.
 
-### Deactivate screen locking, as we mostly running this as a server box via RDP- run this command
+### Set Gnome Terminal's Colors
 
-- ```gsettings set org.gnome.desktop.screensaver lock-enabled false```
+You may configure your terminal colors however you like. Start with this configuration as a default. 
 
-### Set Gnome Terminal's colors (personal preference)- run these commands
+Run these commands in your terminal to download and install our suggested config:
 
-- ```dconf load /org/gnome/terminal/legacy/profiles:/ < gnome-terminal-profiles.dconf```
+1. `wget https://raw.githubusercontent.com/codefellows/setup-guide/main/configs/ops/gnome-terminal-profiles.dconf`
+2. `dconf load /org/gnome/terminal/legacy/profiles:/ < gnome-terminal-profiles.dconf`
+
+### Update System Software
+
+To update other system software, run each of these commands, one at a time in the terminal:
 
 ```bash
 cd ~/Downloads
@@ -23,6 +32,9 @@ sudo apt update
 sudo apt-get update
 sudo apt upgrade -y
 ```
+
+Some of these steps may take some time to complete.
+
 ---
 
 ### [⇐ Previous](./5-virtualbox.md) | [Next ⇒](./7-applications.md)

ops-setup/7-applications.md

@@ -1,42 +1,41 @@
 # Ops Setup
 
-## Install applications and tools
+Now, install some applications and tools
 
-### Install Open SSH Server, allow firewall, and launch the service on startup
+### Add OpenSSH Server:
 
-- ```sudo apt-get install openssh-server -y```
-- ```sudo systemctl start sshd```
-- ```sudo ufw allow ssh```
-- ```sudo systemctl enable ssh```
+1. `sudo apt-get install openssh-server -y`
+1. `sudo systemctl start sshd`
+1. `sudo ufw allow ssh`
+1. `sudo systemctl enable ssh`
 
-### Install VIM
+### Install VIM:
 
-- ```sudo apt install vim -y```
-- ```vim --version >> ~/Downloads/deployerlog.txt```
+1. `sudo apt install vim -y`
+1. `vim --version >> ~/Downloads/deployerlog.txt`
 
-### Install curl
+### Install curl:
 
-- ```sudo apt install curl -y```
-- ```curl --version >> ~/Downloads/deployerlog.txt```
+1. `sudo apt install curl -y`
+1. `curl --version >> ~/Downloads/deployerlog.txt`
 
-### Install Virtalbox
+### Install Virtalbox:
 
-- ```install-virtualbox```
+1. `install-virtualbox`
 
-### Install VS Code
+### Install VSCode:
 
-- ```sudo apt install software-properties-common apt-transport-https wget -y```
-- ```wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add -```
-- ```sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main"```
-- ```sudo apt install code -y```
-- ```code --version >> ~/Downloads/deployerlog.txt```
+1. `sudo apt install software-properties-common apt-transport-https wget -y`
+1. `wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add `
+1. `sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main`
+1. `sudo apt install code -y`
+1. `code --version >> ~/Downloads/deployerlog.txt`
 
-### Set favorite apps
+### Set Favorite Apps
 
 - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'terminal.desktop']"```
 - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'files.desktop']"```
 - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'virtualbox.desktop']"```
-- ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'gns3.desktop']"```
 - ```gsettings set org.gnome.shell favorite-apps "$(gsettings get org.gnome.shell favorite-apps | sed s/.$//), 'code.desktop']"```
 
 ---

ops-setup/8-rdp.md

@@ -1,14 +1,15 @@
 # Ops Setup
 
-## Adjust settings for RDP (Remote Desktop Protocol)
+Adjust settings for RDP (Remote Desktop Protocol). These steps will make your remote-connection sessions easier.
 
-- These will make the RDP sessions easier
+## RDP Config
 
 ### Remove "color profile authentication" popup in XRDP
 
-- ```sudo touch /etc/polkit-1/localauthority/50-local.d/45-allow-colord.pkla```
+Copy this entire block of commands, and paste it into your terminal to run all at once:
 
 ```bash
+sudo touch /etc/polkit-1/localauthority/50-local.d/45-allow-colord.pkla
 sudo cat >> /etc/polkit-1/localauthority/50-local.d/45-allow-colord.pkla <<EOL```
 [Allow Colord all Users]
 Identity=unix-user:*
@@ -19,10 +20,11 @@ ResultActive=yes
 EOL
 ```
 
-Then run:
-- ```sudo rm /var/crash/*```
+Then run: `sudo rm /var/crash`
 
-### Remove “Authentication required to refresh system repositories” popup on login via XRDP
+## Remove “Authentication required to refresh system repositories” popup on login via XRDP
+
+Copy this entire block of commands, and paste it into your terminal to run all at once:
 
 ```bash
 sudo cat >> /etc/polkit-1/localauthority/50-local.d/46-allow-update-repo.pkla <<EOL

ops-setup/9-wrapup.md

@@ -1,9 +1,21 @@
 # Ops Setup
 
-## Wrapup - run the following to see a summary of what was installed
+That's about it!
 
-- ```cat ~/Downloads/deployerlog.txt```
+## Wrapup
+
+We've been tracking some of progress along the way. 
+
+Run the following to see a summary of what was installed:
+
+- `cat ~/Downloads/deployerlog.txt`
+
+Take a moment to review what's reported there.
+
+If it sounds about right, you are done! If you aren't sure, reach out to your instructor to get it verified. 
+
+We can't wait to hear from you, and see you in class!
 
 ---
 
-### That's It! [Back To the Beginning](../README.md)
+### [Back To the Beginning](../README.md)