11079: Final changes following widespread review (#100)

* TimesTen: Initial population

* Work in progress

* Finalising workshop instructions etc.

* QA fixes #1

* QA fixes #2

* Typo and grammar corrections

* URL fixup, additional minor tweaks.

* Minor updates and fixes.

* Improve connection instructions.

* cleanup migration

cleanup migration

* clean up after migration

clean up after migration

* Update to README file

* Various improvements based on feedback.

* URL corrections

* Correcting e-mail address for 'help'

* Tiny changes

* Urgent fixes from first round review

* Latest changes

* Various edits

* More changes

* Final changes before next review cycle

* Fixes and tweaks based on latest review cycle.

* Lots of small changes from team wide review.

 Ready to make public.

Co-authored-by: Kevin Lazarz <kevin.lazarz@oracle.com>

Author: ChrisJ60

timesten/cache-introduction/00-setup-compute/images/create-stack-novnc-2.png

@@ -1,35 +1,34 @@
 # Connect to the workshop compute instance
 
 ## Introduction
-This lab will show you how to login to your pre-created compute instance running on Oracle Cloud.
+This lab shows you how to login to your pre-created compute instance running on Oracle Cloud.
 
 **Estimated Lab Time:** 10 minutes
 
 ### Objectives
-In this lab, you will:
 
-- Learn how to connect to your compute instance using the NoVNC Remote Desktop
-- Learn the basics of using the NoVNC Desktop, including copy and paste
-- Configure and use SSH access to the compute instance (optional)
+- Learn how to connect to your compute instance using the NoVNC Remote Desktop.
+- Learn the basics of using the NoVNC Desktop, including copy and paste.
+- Configure and use SSH access to the compute instance (optional).
 
 ### Prerequisites
 
 This lab assumes:
 
-- You have successfully provisioned a workshop compute instance either in the LiveLabs sandbix or in your own tenancy
-- If you using the LiveLabs sandbox, and you wish to use SSH to access the compute instance, that you have an RSA format SSH private/public key pair to use to access the compute instance (optional)
+- You have successfully provisioned a workshop compute instance either in the LiveLabs sandbix or in your own tenancy.
+- If you using the LiveLabs sandbox, and you wish to use SSH to access the compute instance, that you have an RSA format SSH private/public key pair to use to access the compute instance (optional).
 
 If you wish to use the NoVNC graphical desktop to access the workshop compute instance, please complete **tasks 1 and 2** below.
 
-If you prefer to use SSH to access the compute instance, please complete **task 3** below.
+If you prefer to use SSH to access the compute instance, please complete **tasks 2 and 3** below.
 
 If you wish to be able to use both connection methods, please complete all the tasks in this lab.
 
-**IMPORTANT:** Due to the slightly cumbersome nature of copying between your host system and the NoVNC session, we recommend that you perform all of the copy/paste actions within the NoVNC session itself, as this avoids the use of the NoVNC clipboard. Alternatively, access the workshop's compute instance via SSH and copy/paste between the lab instructions displayed in your local browser and your SSH session.
+**IMPORTANT:** Due to the slightly cumbersome nature of copying between your host system and the NoVNC session, we recommend that you perform all of the copy/paste actions within the NoVNC session itself, as this avoids the use of the NoVNC clipboard. Alternatively, access the workshop's compute instance using SSH and copy/paste between the lab instructions displayed in your local browser and your SSH session.
 
 ## Task 1: Enable NoVNC Full-screen Display
 
-Too make the best use of your display, perform the following tasks to render your remote desktop session in fullscreen mode.
+To make the best use of your display, perform the following tasks to render your remote desktop session in fullscreen mode.
 
 1. Click on the small gray tab on the middle-left side of your screen to open the control bar.
 
@@ -42,7 +41,7 @@ Too make the best use of your display, perform the following tasks to render you
 
 ## Task 2: Enable Copy/Paste from Local to Remote Desktop
 
-During the execution of this workshop you may will to copy text from your local PC/Mac to the remote desktop, such as commands from the lab guide. While such direct copy/paste isn't supported, you may proceed as indicated below to enable an alternative local-to-remote clipboard via the NoVNC Clipboard.
+During the execution of this workshop you will need to copy text from the workshop instructions (use the copy button provided) to a terminal session (remote desktop or SSH). As direct copy/paste between your local browser and the NoVNC desktop isn't supported, you may proceed as indicated below to enable an alternative local-to-remote clipboard using the NoVNC Clipboard.
 
 1. Continuing from the last task above, Select the *clipboard* icon
 
@@ -60,15 +59,15 @@ If you will be using the NoVNC desktop for the workshop, make sure that you have
 
 While your workshop can be executed end-to-end from the remote desktop, follow the steps provided below if you prefer to access the instance remotely using an SSH client such as Putty, Unix/Linux/MacOS Terminal, OCI cloudshell, and other terminal emulators available on Windows.
 
-**IMPORTANT:** If you are running the workshop instance in your own tenancy and you configured SSH access as part of deploying the instance via the ORM stack, skip straight to step **7** below.
+**IMPORTANT:** If you are running the workshop instance in your own tenancy and you configured SSH access as part of deploying the instance using the ORM stack, skip straight to step **7** below.
 
 *Note:* In this section you are enabling SSH access to the OS user running the remote desktop, which for this workshop is the **oracle** user.
 
 This assumes that you already have an RSA type SSH key-pair available on the local system where you will be connecting from. If you don't, then for more info on creating and using SSH keys for your specific platform and client, please refer to the guide [Generate SSH Keys](https://docs.oracle.com/en/learn/generate_ssh_keys/index.html)
 
-1. Open the remote clipboard on the remote desktop as shown in *Task 3* and launch a terminal session
+1. Open the remote clipboard on the remote desktop as shown in *Task 3* and launch a terminal session.
 
-2. Paste the block below onto the remote clipboard first, then onto the terminal to create or update the file *$HOME/.ssh/authorized_keys* using the *vi* editor
+2. Paste the block below onto the remote clipboard first, then onto the terminal to create or update the file *\$HOME/.ssh/authorized_keys* using the *vi* editor.
 
     ```
     <copy>
@@ -93,9 +92,9 @@ This assumes that you already have an RSA type SSH key-pair available on the loc
 
     ![](./images/novnc-copy-pub-key-3.png " ")
 
-5. Save and exit the *vi* editor (press the **Escape** key then type **ZZ**)
+5. Save and exit the *vi* editor (press the **Escape** key then type **ZZ**).
 
-6. Set the required permissions on *authorized_keys*
+6. Set the required permissions on *authorized_keys*.
 
     ```
     <copy>
@@ -113,11 +112,13 @@ This assumes that you already have an RSA type SSH key-pair available on the loc
     </copy>
     ```
 
+    If copy/pasting the above _example_, substitue the appropriate values for the SSH key private key file and the compute instance IP address.
+    
     For Putty, please refer to the guide [Generate SSH Keys](https://oracle-livelabs.github.io/common/labs/generate-ssh-key) on how to establish the connection using the *.ppk* private key.
 
-You should now have an open terminal session in the compute instance, either via the NoVNC desktop or via SSH. Keep this session open for the next lab.
+You should now have an open terminal session in the compute instance, either through the NoVNC desktop or through SSH. Keep this session open for the next lab.
 
-You may now *proceed to the next lab*.
+You can now **proceed to the next lab**.
 
 
 ## Acknowledgements

timesten/cache-introduction/00-setup-compute/images/create-stack-novnc-3.png

@@ -1,17 +1,16 @@
 # Connect to the workshop compute instance using NoVNC Remote Desktop
 
 ## Introduction
-This lab will show you how to login to your compute instance running on Oracle Cloud using the browser based NoVMC remote graphical desktop
+This lab shows you how to login to your compute instance running on Oracle Cloud using the browser based NoVNC remote graphical desktop.
 
-If you configured the workshop compute instance for SSH access when you deployed it, and you prefer to use SSH instead of the graphical remote desktop, then skip this lab and *proceed to the next lab*.
+If you configured the workshop compute instance for SSH access when you deployed it, and you prefer to use SSH instead of the graphical remote desktop, then skip this lab and **proceed to the next lab**.
 
 **Estimated Lab Time:** 10 minutes
 
 ### Objectives
-In this lab, you will:
 
-- Learn how to connect to your compute instance using the NoVNC Remote Desktop
-- Learn the basics of using the NoVNC Desktop, including copy and paste
+- Learn how to connect to your compute instance using the NoVNC Remote Desktop.
+- Learn the basics of using the NoVNC Desktop, including copy and paste.
 
 ### Prerequisites
 
@@ -22,15 +21,15 @@ This lab assumes:
 ## Task 1: Access the Graphical Remote Desktop
 For ease of execution of this workshop, your VM instance has been pre-configured with a remote graphical desktop accessible using any modern browser on your laptop or workstation. Proceed as detailed below to login.
 
-If you prefer to connect to the compute instance using SSH to execute the workshop steps and commands, please skip the rest of this lab and  *proceed to the next lab*.
+If you prefer to connect to the compute instance using SSH to execute the workshop steps and commands, please skip the rest of this lab and  **proceed to the next lab**.
 
-1. Navigate to **Stack Details**, **Application Information** tab, and click on the remote desktop URL
+1. Navigate to **Stack Details**, **Application Information** tab, and **Copy** the remote desktop URL.
 
   ![](./images/create-stack-novnc-10.png " ")
 
   ![](./images/novnc-login-1.png " ")
 
-  This should take you directly to your remote desktop in a single click.
+  Paste this URL into another browser window and it will take you to the remote desktop.
 
   ![](images/novnc-launch-get-started-2.png " ")
 
@@ -44,7 +43,7 @@ You can safely ignore this error. Proceed by clicking on **Details**, and finall
 
 ## Task 2: Enable NoVNC Full-screen Display
 
-Too make the best use of your display, perform the following tasks to render your remote desktop session in fullscreen mode.
+To make the best use of your display, perform the following tasks to render your remote desktop session in fullscreen mode.
 
 1. Click on the small gray tab on the middle-left side of your screen to open the control bar.
 
@@ -57,7 +56,7 @@ Too make the best use of your display, perform the following tasks to render you
 
 ## Task 3: Enable Copy/Paste from Local to Remote Desktop
 
-During the execution of this workshop you may will to copy text from your local PC/Mac to the remote desktop, such as commands from the lab guide. While such direct copy/paste isn't supported, you may proceed as indicated below to enable an alternative local-to-remote clipboard via the NoVNC Clipboard.
+During the execution of this workshop you will need to copy text from the workshop instructions (use the copy button provided) to a terminal session (remote desktop or SSH). As direct copy/paste between your local browser and the NoVNC desktop isn't supported, you may proceed as indicated below to enable an alternative local-to-remote clipboard using the NoVNC Clipboard.
 
 1. Continuing from the last task above, Select the *clipboard* icon
 
@@ -69,11 +68,11 @@ During the execution of this workshop you may will to copy text from your local
 
 *Note:* Please make sure you initialize your clipboard with step [1] shown in the screenshot above before opening the target application in which you intend to paste the text. Otherwise will find the *paste* function in the context menu grayed out when attempting to paste for the first time.
 
-**IMPORTANT:** Due to the slightly cumbersome nature of copying between your host system and the NoVNC session, we recommend that you perform all of the copy/paste actions within the NoVNC session itself, as this avoids the use of the NoVNC clipboard. Alternatively, access the workshop's compute instance via SSH and copy/paste between the lab instructions displayed in your local browser and your SSH session.
+**IMPORTANT:** Due to the slightly cumbersome nature of copying between your host system and the NoVNC session, we recommend that you perform all of the copy/paste actions within the NoVNC session itself, as this avoids the use of the NoVNC clipboard. Alternatively, access the workshop's compute instance using SSH and copy/paste between the lab instructions displayed in your local browser and your SSH session.
 
 If you will be using the NoVNC desktop for the workshop, make sure that you have an open terminal session. If you have closed the terminal session that was open when you first logged in, open a new one now using **Activities > Terminal** from the Linux desktop menu bar. 
 
-You may now *proceed to the next lab*.
+You can now **proceed to the next lab**.
 
 
 ## Acknowledgements