GITBOOK-261: signage: edit setup doc

Author: selsayed25

services/signage/setup.md

@@ -2,7 +2,7 @@
 
 ## Network Configuration Overview
 
-Each Signage Intel Compute Stick connects to TJ's Windows network. Each stick's MAC address is whitelisted by TJ's Tech Team to access the `tjhsst` network. Using [wpa\_supplicant](https://wiki.archlinux.org/index.php/WPA_supplicant) and [systemd-networkd](https://wiki.archlinux.org/index.php/Systemd-networkd), each stick is assigned an IP on the Windows network.
+Each Signage Intel Compute Stick connects to TJ's Windows network. Each stick's MAC address is whitelisted by TJ's Tech Team to access the `tjhsst` network. Using [wpa\_supplicant](https://wiki.archlinux.org/index.php/WPA\_supplicant) and [systemd-networkd](https://wiki.archlinux.org/index.php/Systemd-networkd), each stick is assigned an IP on the Windows network.
 
 ## Installation
 
@@ -16,26 +16,25 @@ This guide will show you how to set up a new stick.
 
 #### Installing the OS
 
-When you first get one of the [Compute Sticks](https://livedoc.tjhsst.edu/wiki/Compute_Sticks), it should come pre-loaded with Windows 10 by default. If this is not the case, you probably got the wrong version of Compute Stick \(the Ubuntu ones aren't powerful enough\).
+When you first get one of the [Compute Sticks](https://livedoc.tjhsst.edu/wiki/Compute\_Sticks), it should come pre-loaded with Windows 10 by default. If this is not the case, you probably got the wrong version of Compute Stick (the Ubuntu ones aren't powerful enough).
 
 **Prepare the Installation USBs**
 
 These steps only have to be done if there are no installation USBs around.
 
-_This guide assumes \(hopefully correctly\) that you know how to manage USBs on whatever computer you are using. If not, just_ [_Google_](https://bing.com) _it._
+_This guide assumes (hopefully correctly) that you know how to manage USBs on whatever computer you are using._
 
 1. Download the OS.
-   * Head on over to Ubuntu's [website](https://ubuntu.com/download/server) and download the  `.iso` for the the latest LTS version \(at the time of this writing 16.04 LTS\).
+   * Head on over to Ubuntu's [website](https://ubuntu.com/download/server) and download the  `.iso` for the the latest LTS version.
 2. Put the OS on a USB.
    * On Linux or Mac, use the `dd` utility to flash a USB with the OS installer. On Windows, use [Win32DiskImager](https://sourceforge.net/projects/win32diskimager/::) or something to that nature.
    * Example `dd` command: `sudo dd if=ubuntu_server-16.04.iso of=/dev/sdx progress=status`, replacing `sdx` with the actual USB device identifier.
 3. Download the `wpa_supplicant` package and dependencies.
-   * On an Ubuntu system with the same architecture as the Compute Stick \(preferably an existing Compute Stick\), use this command to download `wpa_supplicant` and all of its dependencies:
-
-     ```text
-     apt-get download wpa_supplicant && apt-cache depends -i wpa_supplicant | awk '/Depends:/ {print $2}' | xargs apt-get download
-     ```
+   *   On an Ubuntu system with the same architecture as the Compute Stick (preferably an existing Compute Stick), use this command to download `wpa_supplicant` and all of its dependencies:
 
+       ```
+       apt-get download wpa_supplicant && apt-cache depends -i wpa_supplicant | awk '/Depends:/ {print $2}' | xargs apt-get download
+       ```
    * On a Windows or Mac system, you will have to do this manually by tracing dependencies.
 
 **Get Configuration Files**
@@ -44,7 +43,7 @@ There is a GitLab [repo](https://gitlab.tjhsst.edu/signage3/cs-config) which con
 
 You should clone it by running within the mounted wpa\_supplicant drive
 
-```text
+```
 git clone [email protected]:signage3/cs-config.git
 ```
 
@@ -59,14 +58,13 @@ git clone [email protected]:signage3/cs-config.git
    * If you can't boot, [Google](https://google.com) what went wrong.
 6. Follow the on-screen prompts to install Ubuntu Server LTS.
    * Try to install as few extra features as possible.
-   * Set the username/password as user/user for easy installing later on.
-     * We will change the password later on, don't worry.
+   * Set the username/password as instructed by the Signage Lead. The password, however, will be changed later.
 
 **Mount the USB**
 
-Now, plug in the other installation USB \(the one with the packages on it\) into the Compute Stick. Mount it with
+Now, plug in the other installation USB (the one with the packages on it) into the Compute Stick. Mount it with
 
-```text
+```
 sudo mount /dev/sdxn /mnt
 ```
 
@@ -79,7 +77,6 @@ Scripts to complete initial setup of the script can be found on [GitLab](https:/
 * Cd into `/mnt/cs-config`.
 * Run `./setup_network.sh <LAST TWO DIGITS OF IP>` to configure networking.
 * Reboot.
-* Check that you have internet \(`ping`\) and use `ip a` to check that you have been assigned an IP address.
-* Run `./setup_finish.sh` to complete setup \(install python basic config\).
-* From your device, run the CSL Ansible play for signage \(`signage.yml`\) to configure the base of the system.
-
+* Check that you have internet (`ping`) and use `ip a` to check that you have been assigned an IP address.
+* Run `./setup_finish.sh` to complete setup (install python basic config).
+* From your device, run the CSL Ansible play for signage (`signage.yml`) to configure the base of the system.