re-arrange the user docs (#76)

* re-arrange the user docs

* Minor description edit

* update styles

* fix service links

Co-authored-by: kn0wmad <kn0wmad@protonmail.com>
Co-authored-by: Lucy Cifferello <12953208+elvece@users.noreply.github.com>

site/source/user-manual/device-guides/limitations/index.rst

@@ -0,0 +1,16 @@
+.. _limitations:
+
+=================
+Known Limitations
+=================
+
+The following pages describe functionality that is known to be missing from certain platforms.  Please bother the appropriate company or developers until they have been remedied.
+
+.. toctree::
+  :maxdepth: 1
+
+  lim-linux
+  lim-mac
+  lim-windows
+  lim-android
+  lim-ios

site/source/user-manual/device-guides/limitations/lim-android.rst

@@ -0,0 +1,17 @@
+.. _lim-android:
+
+=======
+Android
+=======
+
+Local Access
+------------
+Older versions of Android (previous to version 12, and some custom ROMs, such as Graphene/Calyx) do not have native support for :ref:`mDNS<mdns>` and therefore cannot resolve ``.local`` addresses.  This issue has been long known by Google, and can be tracked `here <https://issuetracker.google.com/issues/140786115>`_ (Google account required to view).
+
+Workarounds
+===========
+An app developer can add mDNS support, and some projects, such as Chromium, have long `considered it <https://bugs.chromium.org/p/chromium/issues/detail?id=405925>`_, but the real solution is for support to occur at the OS level.
+
+LineageOS
+---------
+Unfortunately, there seems to be a bug in Lineage that makes using Firefox over Tor currently unusable.  Currently, this feature works fine on Calyx and Graphene.

site/source/user-manual/device-guides/limitations/lim-ios.rst

@@ -0,0 +1,25 @@
+.. _lim-ios:
+
+===
+iOS
+===
+
+Tor
+---
+It is not currently possible to run Tor natively (in the background) on iOS.  The best chance for this functionality coming to iOS in the future is via the `iCepa Project <https://github.com/iCepa>`_.
+
+Workarounds
+===========
+The only way to use Tor (in the background) on iOS is with apps that come with Tor built-in, such as :ref:`Zap Wallet <zap>`.  For visiting Embassy UI Tor sites, you may use `Onion Browser <https://apps.apple.com/us/app/onion-browser/id519296448>`_ or `Start9's Consulate <https://apps.apple.com/us/app/start9-consulate-browser/id1528124570>`_ application.
+
+Matrix
+------
+The lack of Tor support on iOS means that Element/Matrix cannot be run on an iPhone in conjunction with your Embassy Matrix server, as that currently requires a Tor connection.  This will be fixed when `Element <https://github.com/vector-im/element-ios>`_ builds Tor into their app.  An issue specifically in regard to this can be found `here <https://github.com/vector-im/element-ios/issues/1085>`_.
+
+Workarounds
+===========
+None currently known, but may be solved with forthcoming "clearnet" support on EmbassyOS.
+
+Spark Wallet
+------------
+Unfortunately, Spark cannot currently be used in Consulate.  This issue is being tracked `here <https://github.com/Start9Labs/consulate-ios/issues/30>`__.

site/source/user-manual/device-guides/limitations/lim-linux.rst

@@ -0,0 +1,7 @@
+.. _lim-linux:
+
+=====
+Linux
+=====
+
+Currently, Linux has no known limitations in regard to Embassy.  Congratulations, Master Race...

site/source/user-manual/device-guides/limitations/lim-mac.rst

@@ -0,0 +1,7 @@
+.. _lim-mac:
+
+===
+Mac
+===
+
+MacOS has no known limitations in regard to Embassy at this time.

site/source/user-manual/device-guides/limitations/lim-windows.rst

@@ -0,0 +1,9 @@
+.. _lim-windows:
+
+=======
+Windows
+=======
+
+Windows10 has no known limitations in regard to Embassy at this time.
+
+No testing has been done with other versions, such as Windows 7 or 11.