From 82c5c56d7d40e23890f176c5be2507bfc0fc0492 Mon Sep 17 00:00:00 2001
From: kn0wmad <kn0wmad@protonmail.com>
Date: Mon, 17 Jan 2022 16:33:10 -0700
Subject: [PATCH] Refactor device guides

---
 site/03-todo.md                               | 38 ++++++---------
 .../support/dev-docs/dev-tools/embassyd.rst   | 46 ++++---------------
 .../lan-setup/lan-os/lan-android.rst          |  4 +-
 .../device-guides/dg-android.rst              | 26 ++++++++---
 .../getting-started/device-guides/dg-ios.rst  | 10 ++--
 .../device-guides/dg-linux.rst                | 34 ++++++++------
 .../getting-started/device-guides/dg-mac.rst  | 34 ++++++++------
 .../device-guides/dg-windows.rst              |  2 +-
 8 files changed, 90 insertions(+), 104 deletions(-)

diff --git a/site/03-todo.md b/site/03-todo.md
index abe4255..a3dffb9 100644
--- a/site/03-todo.md
+++ b/site/03-todo.md
@@ -9,11 +9,12 @@
 - [ ] Verify ALL links (especially in device guides as they are all external)
     - [ ] Check all menus behave and display as expected
     - [ ] Verify all TOCs, etc
-- [ ] Add / verify ALL links in the UI go to the right place in docs
+- [ ] Add / verify ALL links in the **UI** go to the right place in docs
 - [ ] Update all guides in service repos
 - [ ] Address build errors
 - [ ] Launch versioned site/docs to start9.com
 - [ ] There are many issues that should be closed by 0.3 docs release, check that this is the case (some issues await new processes in order to test)
+- [ ] Below checklist
 
 <!-- Checklist
 # User Manual
@@ -26,23 +27,18 @@
             - (after release) create badges
 - Configuration
     - Tor Setup
-        - Desktop
-            - Mac
-            - Windows
-        - Mobile
-            - Android
-            - iOS
-        - Browser
-            - FF Desktop
-            - FF Mobile
+        - Mac
+        - Windows
+        - Android
+        - FF OS
+        - FF Mobile
     - LAN Setup
-        - Desktop
-            - Linux
-            - Mac
-            - Windows
-        - Mobile
-            - Android
-            - iOS
+        - Linux
+        - Mac
+        - Windows
+        - Android
+        - iOS
+        - Browsers
 - Tuning
     - DIY Guide
         - Hardware
@@ -51,16 +47,8 @@
         - From Umbrel
     - Advanced Configurations
         - SSH over Tor
-    - EmbassyOS
     - Service-specific Guides
-# Learn
-    - Concepts
-        - Embassy
-            - Device
-            - OS
-            - DIY
 # Developer Documentation
-    - embassyd
     - embassy-sdk
     - Service Packaging Spec
         - Overview
diff --git a/site/source/support/dev-docs/dev-tools/embassyd.rst b/site/source/support/dev-docs/dev-tools/embassyd.rst
index 89d4db2..f40bef8 100644
--- a/site/source/support/dev-docs/dev-tools/embassyd.rst
+++ b/site/source/support/dev-docs/dev-tools/embassyd.rst
@@ -6,47 +6,17 @@ EmbassyD
 
 .. warning:: This is for advanced users only!! Anything you do while SSH'd into your Embassy is NOT SUPPORTED, unless under the guidance of a Start9 technician.
 
-.. When interacting with Embassy directly, you will invariably want to use ``embassy-cli``.  Embassy-CLI can control EmbassyOS in many of the same ways that the UI can, but with finer controls and deeper insights.
+EmbassyD is the daemon that runs everything that could be considered EmbassyOS.
 
-.. In order to use Embassy-CLI, you will first need to authorize yourself with the following command...
+When SSH'd into your Embassy, you may see the status of EmbassyD with the following:
 
-..     .. code-block:: bash
+    .. code-block:: bash
 
-..         embassy-cli auth login
+        systemctl status embassyd
 
-..     and enter your Embassy Master Password at the prompt.
+If you need to restart the daemon for some reason, you can do so with:
 
+    .. code-block:: bash
 
-.. You can enter ``embassy-cli help`` or ``embassy-cli <option> help`` to get an overview of capabilities:
-
-..     .. code-block:: bash
-
-..         Embassy CLI
-
-..         USAGE:
-..             embassy-cli [OPTIONS] <SUBCOMMAND>
-
-..         FLAGS:
-..                 --help       Prints help information
-..             -V, --version    Prints version information
-
-..         OPTIONS:
-..             -c, --config <config>
-..             -h, --host <host>
-..             -p, --proxy <proxy>
-
-..         SUBCOMMANDS:
-..             auth            Login/logout and manage sessions
-..             backup          Manage backups
-..             db              Interact with the Database
-..             disk            Information on the external drive
-..             echo            Echoes
-..             git-info        Print the current git hash
-..             help            Prints this message or the help of the given subcommand(s)
-..             inspect         Details on services and their components
-..             net             Network information
-..             notification    Control UI notifications
-..             package         Interact with packages
-..             server          EmbassyOS operations and information
-..             ssh             Manage SSH keys
-..             wifi            Manage WiFi networks
+        systemctl restart embassyd
+        
\ No newline at end of file
diff --git a/site/source/support/user-manual/configuration/lan-setup/lan-os/lan-android.rst b/site/source/support/user-manual/configuration/lan-setup/lan-os/lan-android.rst
index 1423f7c..5aea590 100644
--- a/site/source/support/user-manual/configuration/lan-setup/lan-os/lan-android.rst
+++ b/site/source/support/user-manual/configuration/lan-setup/lan-os/lan-android.rst
@@ -4,6 +4,4 @@
 Android
 =======
 
-If you are running Android 12, you can setup :ref:`Local Access<lan>`, please see :ref:`Android Limitations <lim-android>` for more details on devices that have this capability.
-
-
+If you are running Android 12+, you can setup :ref:`Local Access<lan>`, please see :ref:`Android Limitations <lim-android>` for more details on devices that have this capability.
diff --git a/site/source/support/user-manual/getting-started/device-guides/dg-android.rst b/site/source/support/user-manual/getting-started/device-guides/dg-android.rst
index ee2fb6d..233cf3a 100644
--- a/site/source/support/user-manual/getting-started/device-guides/dg-android.rst
+++ b/site/source/support/user-manual/getting-started/device-guides/dg-android.rst
@@ -4,14 +4,26 @@
 Android
 =======
 
-.. note:: Please see Android's :ref:`Known Limitations<lim-android>` to understand what is currently not possible on these devices
+.. tip:: Please see Android's :ref:`Known Limitations<lim-android>` to understand what is currently not possible on these devices
 
-Tor Setup (Connectivity)
-------------------------
 
-`Setup Tor <docs.start9.com/user-manual/configuration/tor-setup/tor-os/tor-android>`_ to run natively (in the background) on your device.  This will allow you to use applications on your Android via the :ref:`Tor Network<tor>` so they can communicate with your Embassy.
+.. topic-box::
+    :title: LAN Setup (Connectivity, Performance)
+    :link: https://start9.com/latest/support/user-manual/configuration/lan-setup/lan-android
+    :anchor: Setup
 
-Tor Firefox Config (Connectivity)
----------------------------------
+    For a fast and secure connection while on your Embassy's local network
 
-`Configure Firefox <docs.start9.com/user-manual/configuration/tor-setup/tor-firefox/torff-android>`_ to be able to use the :ref:`Tor Network<tor>` so that you can reach ``.onion`` sites without needing to change browsers.
+.. topic-box::
+    :title: Tor Setup (Connectivity)
+    :link: https://start9.com/latest/support/user-manual/configuration/tor-setup/tor-os/tor-android
+    :anchor: Setup
+
+    Run Tor natively (in the background) on your device.  This will allow you to use applications on your Windows machine via the Tor Network so they can communicate with your Embassy.
+
+.. topic-box::
+    :title: Tor Firefox Config (Connectivity)
+    :link: https://start9.com/latest/support/user-manual/configuration/tor-setup/tor-firefox/torff-android
+    :anchor: Configure
+
+    Configure Firefox to use the Tor Network so that you can reach ``.onion`` sites without needing to change browsers.
diff --git a/site/source/support/user-manual/getting-started/device-guides/dg-ios.rst b/site/source/support/user-manual/getting-started/device-guides/dg-ios.rst
index 6886af0..91053c1 100644
--- a/site/source/support/user-manual/getting-started/device-guides/dg-ios.rst
+++ b/site/source/support/user-manual/getting-started/device-guides/dg-ios.rst
@@ -4,9 +4,11 @@
 iOS
 ===
 
-.. note:: Please see iOS's :ref:`Known Limitations<lim-ios>` to understand what is currently not possible on these devices
+.. tip:: Please see iOS's :ref:`Known Limitations<lim-ios>` to understand what is currently not possible on these devices
 
-LAN Setup (Connectivity, Performance)
--------------------------------------
+.. topic-box::
+    :title: LAN Setup (Connectivity, Performance)
+    :link: https://start9.com/latest/support/user-manual/configuration/lan-setup/lan-ios
+    :anchor: Setup
 
-`Setup LAN Access <docs.start9.com/user-manual/configuration/lan-setup/lan-ios>`_ for a fast and secure connection while on your Embassy's local network.
+    For a fast and secure connection while on your Embassy's local network
diff --git a/site/source/support/user-manual/getting-started/device-guides/dg-linux.rst b/site/source/support/user-manual/getting-started/device-guides/dg-linux.rst
index 87f34ba..15f9310 100644
--- a/site/source/support/user-manual/getting-started/device-guides/dg-linux.rst
+++ b/site/source/support/user-manual/getting-started/device-guides/dg-linux.rst
@@ -4,24 +4,32 @@
 Linux Guides
 ============
 
-.. note:: Please see Linux's :ref:`Known Limitations<lim-linux>` to understand what is currently not possible on these devices
+.. tip:: Please see Linux's :ref:`Known Limitations<lim-linux>` to understand what is currently not possible on these devices
 
-LAN Setup (Connectivity, Performance)
--------------------------------------
+.. topic-box::
+    :title: LAN Setup (Connectivity, Performance)
+    :link: https://start9.com/latest/support/user-manual/configuration/lan-setup/lan-linux
+    :anchor: Setup
 
-`Setup LAN Access <https://docs.start9.com/support/user-manual/configuration/lan-setup/lan-linux>`_ for a fast and secure connection while on your Embassy's local network.
+    For a fast and secure connection while on your Embassy's local network
 
-Tor Setup (Connectivity)
-------------------------
+.. topic-box::
+    :title: Tor Setup (Connectivity)
+    :link: https://start9.com/latest/support/user-manual/configuration/tor-setup/tor-os/tor-linux
+    :anchor: Setup
 
-`Setup Tor <https://docs.start9.com/support/user-manual/configuration/tor-setup/tor-os/tor-linux>`_ to run natively (in the background) on your device.  This will allow you to use applications on your Linux machine via the :ref:`Tor Network<tor>` so they can communicate with your Embassy.
+    Run Tor natively (in the background) on your device.  This will allow you to use applications on your Windows machine via the Tor Network so they can communicate with your Embassy.
 
-Tor Firefox Config (Connectivity)
----------------------------------
+.. topic-box::
+    :title: Tor Firefox Config (Connectivity)
+    :link: https://start9.com/latest/support/user-manual/configuration/tor-setup/tor-firefox/torff-linux
+    :anchor: Configure
 
-`Configure Firefox <https://docs.start9.com/support/user-manual/configuration/tor-setup/tor-firefox/torff-linux>`_ to be able to use the :ref:`Tor Network<tor>` so that you can reach ``.onion`` sites without needing to change browsers.
+    Configure Firefox to use the Tor Network so that you can reach ``.onion`` sites without needing to change browsers.
 
-Embassy Backups (Reliability)
------------------------------
+.. topic-box::
+    :title: Embassy Backups (Resilience)
+    :link: https://start9.com/latest/support/user-manual/walkthrough/backup/backup-lin
+    :anchor: Backup
 
-`Configure Remote Backup <https://docs.start9.com/support/user-manual/walkthrough/backup/backup-lin>`_ of your Embassy to your Linux machine.  **Backups are supremely important** as they ensure redundancy of your data for convenience, as well as preventing loss in case of disaster.
+    Configure remote backups of your Embassy to your Windows machine.  **Backups are supremely important** as they ensure redundancy of your data for convenience, as well as preventing loss in case of disaster.
diff --git a/site/source/support/user-manual/getting-started/device-guides/dg-mac.rst b/site/source/support/user-manual/getting-started/device-guides/dg-mac.rst
index 132e201..665d364 100644
--- a/site/source/support/user-manual/getting-started/device-guides/dg-mac.rst
+++ b/site/source/support/user-manual/getting-started/device-guides/dg-mac.rst
@@ -4,24 +4,32 @@
 Mac
 ===
 
-.. note:: Please see Mac's :ref:`Known Limitations<lim-mac>` to understand what is currently not possible on these devices
+.. tip:: Please see Mac's :ref:`Known Limitations<lim-mac>` to understand what is currently not possible on these devices
 
-LAN Setup (Connectivity, Performance)
--------------------------------------
+.. topic-box::
+    :title: LAN Setup (Connectivity, Performance)
+    :link: https://start9.com/latest/support/user-manual/configuration/lan-setup/lan-mac
+    :anchor: Setup
 
-`Setup LAN Access <https://docs.start9.com/support/user-manual/configuration/lan-setup/lan-mac>`_ for a fast and secure connection while on your Embassy's local network.
+    For a fast and secure connection while on your Embassy's local network
 
-Tor Setup (Connectivity)
-------------------------
+.. topic-box::
+    :title: Tor Setup (Connectivity)
+    :link: https://start9.com/latest/support/user-manual/configuration/tor-setup/tor-os/tor-mac
+    :anchor: Setup
 
-`Setup Tor <https://docs.start9.com/support/user-manual/configuration/tor-setup/tor-os/tor-mac>`_ to run natively (in the background) on your device.  This will allow you to use applications on your Mac via the :ref:`Tor Network<tor>` so they can communicate with your Embassy.
+    Run Tor natively (in the background) on your device.  This will allow you to use applications on your Windows machine via the Tor Network so they can communicate with your Embassy.
 
-Tor Firefox Config (Connectivity)
----------------------------------
+.. topic-box::
+    :title: Tor Firefox Config (Connectivity)
+    :link: https://start9.com/latest/support/user-manual/configuration/tor-setup/tor-firefox/torff-mac
+    :anchor: Configure
 
-`Configure Firefox <https://docs.start9.com/support/user-manual/configuration/tor-setup/tor-firefox/torff-mac>`_ to be able to use the :ref:`Tor Network<tor>` so that you can reach ``.onion`` sites without needing to change browsers.
+    Configure Firefox to use the Tor Network so that you can reach ``.onion`` sites without needing to change browsers.
 
-Embassy Backups (Reliability)
------------------------------
+.. topic-box::
+    :title: Embassy Backups (Resilience)
+    :link: https://start9.com/latest/support/user-manual/walkthrough/backup/backup-mac
+    :anchor: Backup
 
-`Configure Remote Backup <https://docs.start9.com/support/user-manual/walkthrough/backup/backup-mac>`_ of your Embassy to your Mac device.  **Backups are supremely important** as they ensure redundancy of your data for convenience, as well as preventing loss in case of disaster.
+    Configure remote backups of your Embassy to your Windows machine.  **Backups are supremely important** as they ensure redundancy of your data for convenience, as well as preventing loss in case of disaster.
\ No newline at end of file
diff --git a/site/source/support/user-manual/getting-started/device-guides/dg-windows.rst b/site/source/support/user-manual/getting-started/device-guides/dg-windows.rst
index af9768a..bd8e9a4 100644
--- a/site/source/support/user-manual/getting-started/device-guides/dg-windows.rst
+++ b/site/source/support/user-manual/getting-started/device-guides/dg-windows.rst
@@ -4,7 +4,7 @@
 Windows
 =======
 
-.. note:: Please see Window's :ref:`Known Limitations<lim-windows>` to understand what is currently not possible on these devices.
+.. tip:: Please see Window's :ref:`Known Limitations<lim-windows>` to understand what is currently not possible on these devices.
 
 .. topic-box::
     :title: LAN Setup (Connectivity, Performance)