Updated Installation Docs

- Removed Control Surfaces icons and added image thumbnails
CommandPost · Jun 9, 2023 · 0936f1e · 0936f1e
1 parent 1b871a6
commit 0936f1e
Show file tree

Hide file tree

Showing 13 changed files with 70 additions and 37 deletions.
diff --git a/docs/control-surfaces/audioswift.yml b/docs/control-surfaces/audioswift.yml
@@ -1,3 +1,4 @@
 label: AudioSwift
-icon: plug
-order: 91
+#icon: plug
+order: 91
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/gamepad.yml b/docs/control-surfaces/gamepad.yml
@@ -1,3 +1,4 @@
 label: Gamepad
-icon: plug
-order: 90
+#icon: plug
+order: 90
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/keyboard.yml b/docs/control-surfaces/keyboard.yml
@@ -1,3 +1,4 @@
 label: Keyboard
-icon: plug
-order: 100
+#icon: plug
+order: 100
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/loupedeck.yml b/docs/control-surfaces/loupedeck.yml
@@ -1,3 +1,4 @@
 label: Loupedeck
-icon: plug
-order: 92
+#icon: plug
+order: 92
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/midi.yml b/docs/control-surfaces/midi.yml
@@ -1,3 +1,4 @@
 label: MIDI
-icon: plug
-order: 93
+#icon: plug
+order: 93
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/monogram.yml b/docs/control-surfaces/monogram.yml
@@ -1,3 +1,4 @@
 label: Monogram
-icon: plug
-order: 96
+#icon: plug
+order: 96
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/razer.yml b/docs/control-surfaces/razer.yml
@@ -1,3 +1,4 @@
 label: Razer
-icon: plug
-order: 94
+#icon: plug
+order: 94
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/resolve.yml b/docs/control-surfaces/resolve.yml
@@ -1,3 +1,4 @@
 label: Resolve
-icon: plug
-order: 97
+#icon: plug
+order: 97
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/streamdeck.yml b/docs/control-surfaces/streamdeck.yml
@@ -1,3 +1,4 @@
 label: Stream Deck
-icon: plug
-order: 98
+#icon: plug
+order: 98
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/tangent.yml b/docs/control-surfaces/tangent.yml
@@ -1,3 +1,4 @@
 label: Tangent
-icon: plug
-order: 96
+#icon: plug
+order: 96
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/touchbar.yml b/docs/control-surfaces/touchbar.yml
@@ -1,3 +1,4 @@
 label: Touch Bar
-icon: plug
-order: 99
+#icon: plug
+order: 99
+image: static/thumbnail.png
diff --git a/docs/control-surfaces/tourbox.yml b/docs/control-surfaces/tourbox.yml
@@ -1,3 +1,4 @@
 label: TourBox
-icon: plug
-order: 95
+#icon: plug
+order: 95
+image: static/thumbnail.png
diff --git a/docs/installation.md b/docs/installation.md
@@ -1,6 +1,6 @@
 # Installation
 
-You can download the latest release of CommandPost as an DMG package [here](http://commandpost.io).
+You can download the latest release of CommandPost as an DMG package [here](/download/).
 
 Once downloaded, simply open the package by double-clicking it.
 
@@ -12,11 +12,15 @@ The DMG package will open, looking like this:
 
 ![](static/commandpost-dmg.png)
 
-Drag the CommandPost icon to the Folder icon. This will put CommandPost in your Application folder.
+Drag the CommandPost icon to the Folder icon.
+
+This will put CommandPost in your **Applications** folder.
 
 ![](static/application-folder.png)
 
-Navigate to your Application folder by double clicking the folder icon, and double click the CommandPost icon. You might be presented with another warning like below - click **Open** to continue installation.
+Navigate to your **Applications** folder by double-clicking the folder icon, and double-click the CommandPost icon.
+
+You might be presented with another warning like below - click **Open** to continue installation.
 
 ![](static/app-warning.png)
 
@@ -26,7 +30,7 @@ CommandPost will now launch the Welcome Screen:
 
 Click **CONTINUE**.
 
-You'll then be presented with the Accessibility Permissions screen:
+You'll then be presented with the **Accessibility Permissions** screen:
 
 ![](static/welcome-2.png)
 
@@ -36,41 +40,56 @@ When you click **ALLOW ACCESSIBILITY**, macOS will present you with this:
 
 Click **Open System Preferences**.
 
-When the **Privacy** Tab of the **Security & Privacy** System Preferences opens, you'll see CommandPost in the "Allow the apps below to control your computer" list. However the panel is locked, so you need to click the paddock icon in the bottom left corner of the screen to make changes.
+When the **Privacy** Tab of the **Security & Privacy** System Preferences opens, you'll see CommandPost in the **Allow the apps below to control your computer** list.
+
+However the panel is locked, so you need to click the paddock icon in the bottom left corner of the screen to make changes.
 
 ![](static/welcome-4.png)
 
-Use touch ID or enter your computers password to unlock:
+Use Touch ID or enter your computers password to unlock:
 
 ![](static/welcome-5.png)
 
-Once the preferences are unlocked, you can tick CommandPost in the list. As soon as you click it, System Preferences will close, and you'll go back to the CommandPost setup, presented with the Screen Recording Permissions screen:
+Once the preferences are unlocked, you can tick CommandPost in the list.
+
+As soon as you click it, System Preferences will close, and you'll go back to the CommandPost setup, presented with the Screen Recording Permissions screen:
 
 ![](static/welcome-6.png)
 
+
+!!!warning Are you recording my screen?
+No, we're **not** recording your screen. You can learn more [here](/faq/#why-does-commandpost-require-screen-recording-permissions).
+!!!
+
 When you click **ALLOW SCREEN RECORDING**, the **Privacy** Tab of the **Security & Privacy** System Preferences opens.
 
-You'll see CommandPost in the "Allow the apps below to record the content of your screen, even while using other apps." list. Again, the panel is locked, so you need to click the paddock icon in the bottom left corner of the screen to make changes.
+You'll see CommandPost in the **Allow the apps below to record the content of your screen, even while using other apps** list.
+
+Again, the panel is locked, so you need to click the paddock icon in the bottom left corner of the screen to make changes.
 
 ![](static/welcome-7.png)
 
-Use touch ID or enter your computers password to unlock:
+Use Touch ID or enter your computers password to unlock:
 
 ![](static/welcome-8.png)
 
-Once the preferences are unlocked, you can tick CommandPost in the list. As soon as you click it, MacOS will ask you to quit and reopen CommandPost.
+Once the preferences are unlocked, you can tick CommandPost in the list.
+
+As soon as you click it, MacOS will ask you to quit and reopen CommandPost.
 
 ![](static/welcome-9.png)
 
 Choose **Quit & Reopen**, then after a short delay, CommandPost will close the System Preferences panel and present you with the CommandPost setup:
 
 ![](static/welcome-1.png)
 
-Since you have already grant the permission CommandPost needs, clicking **CONTINUE** will bring you straight to the Scan Final Cut Pro screen.
+Since you have already granted the permissions CommandPost needs, clicking **CONTINUE** will bring you straight to the **Scan Final Cut Pro** screen (if you have Final Cut Pro installed):
 
 ![](static/welcome-10.png)
 
-When you click **START SCAN** CommandPost will begin scanning your system for Final Cut Pro Plugins & Motion Templates. This process can take several minutes to complete.
+When you click **START SCAN** CommandPost will begin scanning your system for Final Cut Pro Plugins & Motion Templates.
+
+This process can take several minutes to complete depending on your computer and hard drive speed.
 
 ![](static/welcome-11.png)
 
@@ -80,4 +99,6 @@ Once the scanning is complete you'll be presented with:
 
 Click **CLOSE**, and you're ready to use CommandPost!
 
-You can access CommandPost's features via it's [menubar icon](http://help.commandpost.io/interface/menubar).
+You can access CommandPost's features via it's [menubar icon](/interface/menubar/).
+
+Have fun!