diff --git a/site/03-todo.md b/site/03-todo.md index caee33a..4ef2df2 100644 --- a/site/03-todo.md +++ b/site/03-todo.md @@ -1,8 +1,6 @@ # ToDo - [ ] Refactor and update Roadmap -- [ ] Document diagnostic UI -- [ ] Document Bug Reporting - [ ] Footer links need update (or removal?) - [ ] Add screenshots and details - [ ] Verify ALL links (especially in device guides as they are all external) @@ -42,13 +40,12 @@ - Development FAQ - Contributing - Service Packaging + - Alt Market Build Guide -# About - - Mission / values +- Mission / values - Backups - CIFS - OS guides for CIFS - Local - Migrations -- Bug reports -- Diag UI +- Possible sounds in troubleshooting (and walkthrough?) diff --git a/site/source/support/user-manual/configuration/basic-config.rst b/site/source/support/user-manual/configuration/basic-config.rst index 6c398cf..e4357e5 100644 --- a/site/source/support/user-manual/configuration/basic-config.rst +++ b/site/source/support/user-manual/configuration/basic-config.rst @@ -1,7 +1,7 @@ .. _basic-config: =================== -Basic Configuration - ***NEEDS BUG REPORT LINK*** +Basic Configuration =================== .. _auto-reporting: @@ -9,7 +9,7 @@ Basic Configuration - ***NEEDS BUG REPORT LINK*** Automatically Report Bugs ------------------------- -You are asked at first setup if you would like to provide bug reports to Start9. You can edit that setting here if you change your mind. This data is anonymous and you can see exactly what is collected `here<>`. +You are asked at first setup if you would like to provide bug reports to Start9. You can edit that setting here if you change your mind. This data is anonymous and you can see exactly what is collected :ref:`here`. 1. As in the :ref:`Set Device Name` steps above, go to the ``Embasssy`` tab, then under ``Settings``, click ``Preferences`` 2. Click ``Auto Report Bugs`` and either ``Enable`` or ``Disable`` 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 233cf3a..bccb60c 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 @@ -1,8 +1,8 @@ .. _dg-android: -======= -Android -======= +============== +Android Guides +============== .. tip:: Please see Android's :ref:`Known Limitations` to understand what is currently not possible on these devices 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 91053c1..f645be6 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 @@ -1,8 +1,8 @@ .. _dg-ios: -=== -iOS -=== +========== +iOS Guides +========== .. tip:: Please see iOS's :ref:`Known Limitations` to understand what is currently not possible on these devices 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 665d364..6962181 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 @@ -1,8 +1,8 @@ .. _dg-mac: -=== -Mac -=== +========== +Mac Guides +========== .. tip:: Please see Mac's :ref:`Known Limitations` to understand what is currently not possible on these devices 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 bd8e9a4..a3eba24 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 @@ -1,8 +1,8 @@ .. _dg-windows: -======= -Windows -======= +============== +Windows Guides +============== .. tip:: Please see Window's :ref:`Known Limitations` to understand what is currently not possible on these devices. diff --git a/site/source/support/user-manual/index.rst b/site/source/support/user-manual/index.rst index 0d2d682..86a7c2a 100644 --- a/site/source/support/user-manual/index.rst +++ b/site/source/support/user-manual/index.rst @@ -11,9 +11,9 @@ User Manual getting-started/index walkthrough/index configuration/index - troubleshooting/index tuning/index services/index + troubleshooting/index .. panel-box:: :title: Overview diff --git a/site/source/support/user-manual/troubleshooting/shoot-embassy.rst b/site/source/support/user-manual/troubleshooting/shoot-embassy.rst index 23a3eb3..c106101 100644 --- a/site/source/support/user-manual/troubleshooting/shoot-embassy.rst +++ b/site/source/support/user-manual/troubleshooting/shoot-embassy.rst @@ -11,7 +11,11 @@ Embassy is making noises ======================== The plug and play Embassy sold by Start9 has no moving parts, so the only noises it should ever make would come from its internal speaker. The following is a list of all possible sounds: -#. +#. + +Embassy boots into "Diagnostic Mode" +==================================== +Diagnostic Mode is a new UI that will launch in the event that no drive, or an incorrect drive (such as one from another Embassy) has been plugged into Embassy. Simply plug your external drive in and reboot (power off and on again). Embassy will not boot ===================== diff --git a/site/source/support/user-manual/walkthrough/error-logs.rst b/site/source/support/user-manual/walkthrough/error-logs.rst new file mode 100644 index 0000000..4eae224 --- /dev/null +++ b/site/source/support/user-manual/walkthrough/error-logs.rst @@ -0,0 +1,25 @@ +.. _error-logs: + +============================= +Anonymous Error Log Reporting +============================= + +When you fire up your Embassy for the first time, you will be greeted with a modal asking you if you would be willing to provide your error logs to Start9 to assist us in improving EmbassyOS and its ecosystem. The decision to send or retain this data is 100% yours. Below are details to aid you in determining your choice. + +Why do we ask for this? +----------------------- +The last thing Start9 wants is data that relates to users of EmbassyOS, but data that is generated within the system is *extremely* helpful for our engineers to stabilize and enhance the software. + +What data is sent? +------------------ +* Every log entry that is WARN or above, such as: + * Service crashes + * Failed updates +* Metadata, such as: + * What services are running + +Data is catalogued with a random 64-bit integer that is generated upon creating a new :ref:`Session`. Data cannot be correlated across sessions. This means that every time you create a new session, such as a browser log on, error logs are attached to that session *only*, and you can kill a session at any time (see :ref:`Active Sessions`). These session ids are NOT used during support sessions (they are not even provided to the user), such that a support technician CAN NOT attach any kind of identity to a session or its logs. + +How is data sent? +----------------- +These error logs are sent exclusively across Tor, and as such, we cannot even identify what machine, address, or user sent them. diff --git a/site/source/support/user-manual/walkthrough/index.rst b/site/source/support/user-manual/walkthrough/index.rst index ca410cd..e08b031 100644 --- a/site/source/support/user-manual/walkthrough/index.rst +++ b/site/source/support/user-manual/walkthrough/index.rst @@ -9,6 +9,7 @@ An overview of EmbassyOS general capabilities. .. toctree:: :maxdepth: 2 + error-logs overview updates backups