Update the getting started page, and move the appropriate linked files to under the new resource hub and help menus

Author: ronzulu

docs/Quickstart/FAQ.md renamed to docs/Help/FAQ.md

@@ -14,7 +14,7 @@ Talon does not require special configuration for different programming languages
 
 ### What hardware should I have?
 
-Check out the [hardware](./Hardware/hardware.md) page for microphone and eye tracker recommendations.
+Check out the [hardware](../Resource%20Hub/Hardware/hardware) page for microphone and eye tracker recommendations.
 
 ### Are languages other than English supported?
 

docs/Quickstart/beta_talon.md renamed to docs/Help/beta_talon.md

@@ -1,47 +1,123 @@
 ---
-sidebar_position: 1
+sidebar_position: 1.1
 ---
 
-# Getting Started
+# Installation Guide
 
+:::docoscope Talon 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](../Resource%20Hub/Hardware/hardware.md), covering the computer hardware, operating system and microphone hardware.
+
+## 2: Download & Install Talon
+
+<details>
+  <summary>Linux Users</summary>
+  - Download [Talon for Linux](https://talonvoice.com)
+  - Install by **To be completed**
 :::note
 
-You can also install and run Talon by following the [official installation instructions](https://talonvoice.com/docs/). This info supplements that page.
+- Talon, like many tools for automation or accessibility, **does not support Wayland**
+  - You will have to select an X11 session from your login manager.
+  - This is supported by Gnome and Plasma and many others, but some environments like sway are explicitly Wayland-only.
+- To install the speech engine, you must use Talon's tray icon:
+  - If you use stock Gnome, you need to install [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/) to see it
+  - If you use i3 or a system tray that doesn't support the `StatusNotifierItem` protocol, install [snixembed](https://git.sr.ht/~steef/snixembed) to add support.
 
 :::
 
-## 1: [Download Talon](https://talonvoice.com/)
+</details>
 
 <details>
-  <summary>Notes for Linux Users</summary>
-  - Talon, like many tools for automation or accessibility, __does not support Wayland__
-     - You will have to select an X11 session from your login manager.
-    - This is supported by Gnome and Plasma and many others, but some environments like sway are explicitly Wayland-only.
--  To install the speech engine, you must use Talon's tray icon:
-   * If you use stock Gnome, you need to install [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/) to see it
-   * If you use i3 or a system tray that doesn't support the `StatusNotifierItem` protocol, install [snixembed](https://git.sr.ht/~steef/snixembed) to add support.
+  <summary>Mac Users</summary>
+  - Download [Talon for Mac](https://talonvoice.com)
+  - Install by **To be completed**
+</details>
 
+<details>
+  <summary>Windows Users</summary>
+  - Download [Talon for Windows](https://talonvoice.com)
+  - Install Talon by running `talon-windows.exe`
+:::note
+It is recommended that Talon is installed as described above.
+However, please note that the application is also available as a [portable zip file](https://talonvoice.com/dl/latest/talon-windows.zip)
+:::
 </details>
 
-## 2: Install a speech recognition engine
+## 3: Install a speech recognition engine
+
+Talon uses a local speech recognition engine that translates voice audio to text.
+
+One recognition engine that comes with Talon is known as `Conformer D`. To install it:
+
+- Run the Talon app
+- Click the Talon tray icon and select `Speech Recognition → Conformer D`.
+
+<details>
+  <summary>Screenshot</summary>
+<img src="/img/talon_ui/talon_menu_speech_recognition_conformer.png"
+     alt="screenshot of the Windows desktop showing the speech recognition menu"
+ />
+</details>
+
+:::note
+For other engine options, see the [speech engine page](/docs/Resource%20Hub/Speech%20Recognition/speech%20engines.md)
+:::
+
+## 4: Download the Talon user file set
+
+:::important
+Talon does not come with voice commands out of the box. So at this point in the installation process,
+Talon can not do anything useful.
+
+It requires a `user file set` and
+for beginners, we strongly recommend that you use the [Talon Community](https://github.com/talonhub/community) user file set.
+
+If you install a different user file set then portions of this wiki will not be relevant.
+These will be marked as such.
+:::
+
+
+
+
+A `user file set` is simply a bunch of files that need to be downloaded and placed in the correct directory -
+the talon user directory.
+<!-- Update in later phase of https://github.com/TalonCommunity/Wiki/pull/312
+the [talon user directory](/docs/Resource%20Hub/terminology).
+-->
+
+:::docoscope community
+
+:::
+
+This can be done one of two ways - either as a `zip` file or by using `git`.
+Considerations in choosing between the two methods, as well as instructions, are described [here](../Resource%20Hub/Talon%20Installation/downloading-community).
 
-Talon uses a local speech recognition engine that translates voice audio to text. To install your speech engine, click the Talon tray icon and select `Speech Recognition → Conformer D`. For other engine options, see the [speech engine page](./Speech%20Engines/speech%20engines.md)
+## 5: Test your Talon Setup
 
-## 3: Install a Talon user file set
+If you have installed talon community, try a few [basic commands](/docs/Basic%20Usage/basic_usage.md).
 
-Talon does not come with voice commands out of the box. To start, we strongly recommend that you use the [Talon Community](https://github.com/talonhub/community) user file set. The whole wiki assumes this repository is used if not otherwise noted.
+If you have installed a different user file set, consult its documentation on usage.
 
-See the [Talon Community README](https://github.com/talonhub/community?tab=readme-ov-file#installation) for installation instructions.
+## 6: Next steps
 
-In addition to [Talon Community](https://github.com/talonhub/community), you may want to consider installing any of the [essential Talon integrations](../Integrations/essential-tools.md)
 
-## 4: Test your Talon Setup
+- If needed, try ways to [improve recognition accuracy](../Resource%20Hub/Speech%20Recognition/improving_recognition_accuracy.md)
+- [Customize Talon](../Customization/basic_customization): learn about how to configure Talon to your liking.
+ - If at any point you need help with your Talon setup, join the [Talon Voice Slack](https://talonvoice.com/chat) and ask in the `#help` channel.
+- For earlier access to new features, priority support, and access to additional [speech engines](/docs/Resource%20Hub/Speech%20Recognition/speech%20engines.md), install the [beta version](../Help/beta_talon).
 
-- Try a few [basic commands](../Basic%20Usage/basic_usage.md).
-- If needed, try ways to [improve recognition accuracy](improving_recognition_accuracy.md)
-- [Customize Talon](../Customization/basic_customization.md): learn about how to configure Talon to your liking.
-- For earlier access to new features, priority support, and access to additional [speech engines](./Speech%20Engines/speech%20engines.md), install the [beta version](beta_talon.md).
+<!-- Update in later phase of https://github.com/TalonCommunity/Wiki/pull/312
+- If needed, try ways to [improve recognition accuracy](/docs/Resource%20Hub/Speech%20Recognition/improving_recognition_accuracy)
+ -->
 
-## Join the Talon Slack
+<!-- Update in later phase of https://github.com/TalonCommunity/Wiki/pull/312
+- In addition to [Talon Community](https://github.com/talonhub/community), you may want to consider installing any of the popular [Talon integrations](/docs/Integrations/integrations.md)
+ -->
 
-If at any point you need help with your Talon setup, join the [Talon Voice Slack](https://talonvoice.com/chat) and ask in the `#help` channel.

docs/Quickstart/getting_started.md

@@ -57,7 +57,7 @@ Windows default drivers have a limitation and that they _cannot_ record and play
 Check out the `#eye-tracking` channel in Slack, and the [Tobii 4c Tips](tobii_4c) page.
 
 - Tobii 4C is a commonly used and recommended eye tracker, but it is slowly being superceded as the default as more folks are starting to use the Tobii 5. Talon also supports the Tobii PCEye Mini. Support for most 4th gen Tobii devices can be trivially added.
-- [Tobii 5](https://gaming.tobii.com/product/eye-tracker-5/) is the newer model and may be easier to find than the 4C. This one does require a one-time initialization on a Windows PC with the Tobii software installed. Check out the dedicated [Tobii 5 page](../Hardware/tobii_5.md).
+- [Tobii 5](https://gaming.tobii.com/product/eye-tracker-5/) is the newer model and may be easier to find than the 4C. This one does require a one-time initialization on a Windows PC with the Tobii software installed. Check out the dedicated [Tobii 5 page](tobii_5).
 
 ### Windows Login plus Talon
 

docs/Quickstart/Hardware/_category_.yml renamed to docs/Resource Hub/Hardware/_category_.yml

@@ -22,4 +22,4 @@ Regardless of which OS you will be using when you use your eye tracker, the init
 
 ### Next steps
 
-The [Tobii 4c tips](../Hardware/tobii_4c.md) page has detailed instructions on how to adjust your environment and behaviour to get a better eye tracking experience.
+The [Tobii 4c tips](../Hardware/tobii_4c) page has detailed instructions on how to adjust your environment and behaviour to get a better eye tracking experience.

docs/Quickstart/Hardware/hardware.md renamed to docs/Resource Hub/Hardware/hardware.md

@@ -12,7 +12,7 @@ A quiet room will always be better than a noisy one. A good microphone can mitig
 
 ## Microphone
 
-Make sure that you have a good microphone and sound card, as speech recognition software requires better hardware than is commonly built in to computers. Have a look at the [hardware page](./Hardware/hardware.md) for recommendations and correct setup.
+Make sure that you have a good microphone and sound card, as speech recognition software requires better hardware than is commonly built in to computers. Have a look at the [hardware page](../Hardware/hardware) for recommendations and correct setup.
 
 ## Keep a relaxed voice