Mac
### Check that Talon is Awake
-When Talon is running, it will be in one of a few different [modes](../Basic%20Usage/basic_usage). One of these modes is a `sleep` mode, which will put Talon in a dormant state where it is listening but not responding to commands. While asleep, Talon will only respond to a minimal set of commands, such as `talon wake`, which will put Talon out of sleep and enable Talon to respond to commands.
+When Talon is running, it will be in one of a few different [modes](../../Basic%20Usage/basic_usage). One of these modes is a `sleep` mode, which will put Talon in a dormant state where it is listening but not responding to commands. While asleep, Talon will only respond to a minimal set of commands, such as `talon wake`, which will put Talon out of sleep and enable Talon to respond to commands.
If you are trying to use Talon commands and Talon is not responding, make sure Talon is not in sleep mode. The Talon icon in the menubar provides some visual cue as to what mode Talon is in:
-You can also check which which microphone is selected by looking in the talon logs, which are located in `~/.talon/talon.log`. Look for a log that looks like this:
+You can also check which which microphone is selected by looking in the Talon logs, which are located in `~/.talon/talon.log`. Look for a log that looks like this:
`2020-03-04 15:27:53 INFO Activating Microphone: "Yeti Nano Analogue Stereo"`
@@ -133,7 +133,7 @@ Check that your speech engine has been initialized by looking in the [talon log
### Check your Talon user file sets
-Check you have some valid commands in `~/.talon/user`. If it's empty, install the [Talon Community](https://github.com/talonhub/community) user file set and test with some [basic commands](../Basic%20Usage/basic_usage). Install the entire repository, not just individual files. This user file set can be combined with other Talon user file sets, though it is common that most of the functionality will be provided by [Talon Community](https://github.com/talonhub/community). Additional file sets are commonly used to customize the default behavior provided by [Talon Community](https://github.com/talonhub/community) or add additional features not already included.
+Check you have some valid commands in `~/.talon/user`. If it's empty, install the [Talon Community](https://github.com/talonhub/community) user file set and test with some [basic commands](../../Basic%20Usage/basic_usage). Install the entire repository, not just individual files. This user file set can be combined with other Talon user file sets, though it is common that most of the functionality will be provided by [Talon Community](https://github.com/talonhub/community). Additional file sets are commonly used to customize the default behavior provided by [Talon Community](https://github.com/talonhub/community) or add additional features not already included.
Talon automatically tracks changes to files in `~/.talon/user`, so that one can change scripts on the fly. This breaks if `~/.talon` (or any other part of the path) is a symlink.
diff --git a/docs/Resource Hub/Talon Installation/downloading-community.md b/docs/Resource Hub/Talon Installation/downloading-community.md
new file mode 100644
index 00000000..095337d1
--- /dev/null
+++ b/docs/Resource Hub/Talon Installation/downloading-community.md
@@ -0,0 +1,98 @@
+# Downloading the Talon Community User File Set
+
+After installing Talon and a speech recognition engine, as described here
+you will need to download a user file set. This wiki is all about the Talon community user file set
+and so this page is about downloading that specific user file set.
+
+This can be done using two different methods, using zip and using git.
+
+The background to this choice is that if you use Talon for any period of time,
+you can expect the following:
+
+- The community will update the `user file set` with bug fixes and new features, and you will want
+ to update your local copy of it.
+- You might make your own changes to some of these files.
+
+---
+
+## Considerations
+
+### About `zip`
+
+This is easier to get started with Talon as it involves only downloading a single file and using standard
+methods on your PC to extract all the files from it.
+
+The disadvantage is longer term. Periodically on those occasions when you download the latest community user file set, you will manually need to keep track of which files you have changed
+and make sure those changes aren't lost during the update.
+
+:::tip
+
+Make a backup of the whole Talon user directory prior to replacing it with a fresh download of the community user file set.
+
+:::
+
+### About `git`
+
+The benefit of `git`, is that it makes it easy to obtain the latest files without losing any changes you've made in the meantime.
+This is a benefit when using Talon longer term.
+
+If you haven't already heard of `git`, you might find that this approach makes it a little harder to get started with Talon.
+`git` is a very extensive tool, but you will only need to use it in a minimal way. Even still, there will be terms that you will come across such as `repository`, `branch` and `working directory`.
+
+`git` is available as both a command line utility and as a GUI application.
+If you are not particularly comfortable usihellong a command terminal, you may prefer a GUI application such as [`GitHub Desktop`](https://docs.github.com/en/desktop/overview/about-github-desktop).
+
+### Summary
+
+If you are not particularly comfortable using a command terminal, and if you are just wanting to explore the suitability of Talon
+you may wish to use the simpler method of downloading `zip` files.
+
+You will always be able to switch to using `git` down the track.
+
+---
+
+## Instructions
+
+### Installing Using the Zip File
+
+In this method, the zip file is downloaded from:
+https://github.com/talonhub/community
+
+Click on the `Code` button:
+
+
+And download the zip file:
+
+
+- Extract the files. If you don’t know how to extract zip files, a quick google search for "extract zip files" may be helpful.
+- Place these extracted files inside the `user` folder of the Talon Home directory. You can find this folder by right-clicking the Talon icon in the taskbar (Windows) or clicking the Talon icon in the menu bar (Mac), clicking Scripting > Open ~/talon, and navigating to `user`.
+
+### Installing Using Git
+
+If you wish to install `community` by using git, proceed as follows:
+
+#### Linux & Mac
+
+1. Install [`git`](https://git-scm.com/)
+1. Open a terminal ([Mac](https://support.apple.com/en-gb/guide/terminal/apd5265185d-f365-44cb-8b09-71a064a42125/mac) / [Ubuntu](https://ubuntu.com/tutorials/command-line-for-beginners#3-opening-a-terminal))
+1. Paste the following into the terminal window then press Enter/Return:
+
+```bash
+cd ~/.talon/user
+git clone https://github.com/talonhub/community community
+```
+
+#### Windows
+
+1. Install [`git`](https://git-scm.com/)
+2. Open a [command prompt](https://www.wikihow.com/Open-the-Command-Prompt-in-Windows)
+3. Paste the following into the command prompt window then press Enter:
+
+```
+cd %AppData%\Talon\user
+git clone https://github.com/talonhub/community community
+```
diff --git a/docs/Resource Hub/Talon Installation/installation_guide.md b/docs/Resource Hub/Talon Installation/installation_guide.md
new file mode 100644
index 00000000..5ad915c7
--- /dev/null
+++ b/docs/Resource Hub/Talon Installation/installation_guide.md
@@ -0,0 +1,122 @@
+---
+sidebar_position: 1.1
+---
+
+# Installation Guide
+
+:::info talon-scope-platform
+
+Although much of this page is pertinent to the Talon platform itself,
+some steps are specific to the Talon community user file set, and will be marked as such.
+
+:::
+
+## 1: Check System Requirements
+
+Talon has various [system requirements](../Hardware/os), covering the computer hardware, operating system and microphone hardware.
+
+## 2: Download & Install Talon
+
+
+