Improve FAQ clarity

FAQ.rst

@@ -1,15 +1,17 @@
 Frequently Asked Questions
 ==========================
 
+.. _faq_common_issues:
+
 Common Issues
 -------------
 
 If CryptPad is not working as expected there are a few common things to try. Most of these relate to web browsers and extensions that either interfere with CryptPad's security features or disable basic browser functionality.
 
 #. Check the list of extensions below, disable the ones you have installed, if any
 #. Try using your browser in a private window and/or with all extensions disabled
-#. Try using a different browser. We recommend the latest versions of Firefox or Chromium
-#. If the issues persist, please contact support
+#. Try using a different browser. We recommend the latest versions of `Firefox <https://www.mozilla.org/en-US/firefox/new/>`_ or `Chromium <https://www.chromium.org/Home/>`_
+#. If the issues persist, please contact your instance :ref:`support`
 
 List of extensions known to cause issues with CryptPad
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -31,7 +33,7 @@ List of extensions known to cause issues with CryptPad
 * User-Agent Switcher and Manager
 
 .. note::
-    If you identify issues with another extension please `report it to the development team <https://github.com/cryptpad/cryptpad/issues/new/choose>`_
+    If you identify issues with another extension please `report it <https://github.com/cryptpad/cryptpad/issues/new/choose>`_  to the development team
 
 I forgot my password
 --------------------
@@ -43,108 +45,108 @@ If you are still logged in to an account for which you have forgotten the passwo
 1. While logged in to the account with the lost password, navigate to: **User Menu** (avatar at the top right) > |gear| **Settings** > |hdd-o| **CryptDrive**
 2. Click the **Backup** button to download a file containing the keys to all documents. (note: this is different to **Download my Cryptdrive** that saves the content of all individual documents)
 3. In another browser, register a new account with a known password
-4. While logged in to the new account: **User Menu** (avatar at the top right) > |gear| **Settings** > |hdd-o| **CryptDrive** and click the **Restore** button.
+4. While logged in to the new account: **User Menu** (avatar at the top right) > |gear| **Settings** > |hdd-o| **CryptDrive** and click the **Restore** button
 
-How to import/export my documents to/from another platform?
------------------------------------------------------------
+How to import/export to/from another platform?
+----------------------------------------------
 
-Making CryptPad compatible with a wide range of document formats is an ongoing challenge for the development team. Unfortunately the technology for converting documents in the browser still has limitations, especially as far as private and open source solutions are concerned. While work in this area is in progress, the methods below should help in importing and exporting to/from other widely used software.
+Making CryptPad compatible with a wide range of document formats is an ongoing challenge for the development team. While work in this area is in progress, the methods below should help in importing and exporting to/from other widely used software.
 
 .. note::
     Simply copy-pasting content from existing software into CryptPad is an easy first step to try when importing/exporting. Please note that the import/export methods below can improve results significantly.
 
-It is possible to upload **files** to CryptPad for secure storage and sharing, however this does not make every file an editable CryptPad **document**.
+It is possible to upload **files** to CryptPad for secure storage and sharing, however this does not make every file an editable CryptPad **document** right away. For this, you either have to:
+
+- ``Right click`` on the uploaded file > **Open in editor**, or...
+- Create a blank document and use the |file-o| **File** > |upload| **Import** functionality in the appropriate CryptPad editor as explained below
 
-Text files uploaded as files can be opened as a Code/Markdown document from the Drive with ``Right click`` > |cptools code| **Open in Code editor**.
+.. warning::
+    - The `Safari <https://www.apple.com/safari/>`_ web browser, used on macOS, iPadOS and iOS, isn't supported at this time
+    - Support for `CSV <https://en.wikipedia.org/wiki/Comma-separated_values>`_ is currently broken, ``.csv`` import/export is disabled for the time being
+    - Support for `OpenDocument formats <https://en.wikipedia.org/wiki/OpenDocument>`_, ``.odt``, ``.odp`` & ``.ods`` import/export is currently experimental and prone to errors
 
-To import any other file type in an editable form, please use the |file-o| **File** > |upload| **Import** functionality in the appropriate CryptPad editor as explained below.
+If you encounter any issues, please check the :ref:`faq_common_issues` first. If you aren't able to make it work following these instructions, please reach out to your instance administrators through the :ref:`support` help desk. Providing an example document with the :ref:`share_link` functionality.
 
 Import/export is not visible in the File menu
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 For spreadsheets and advanced document processing, Cryptpad integrates OnlyOffice. As a result, there are two toolbars each with their own File menu on the same screen. Please make sure to check in both menus, when looking for import/export.
 
-.. note::
-    See the `warning note <https://docs.cryptpad.org/en/user_guide/apps/sheets.html#toolbars>`_ in our Spreadsheet application documentation.
-
-Rich text document import/export
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To import rich text documents (Microsoft Word, Google Docs, LibreOffice Writer, etc.), the supported format is HTML:
+Document application import/export
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-1. Export your document as HTML in your existing software.
-2. Save the file to your computer.
-3. Open a new :ref:`app_rich_text` document on CryptPad (or an existing one to replace the contents).
-4. |file-o| **File** > |upload| **Import** and select your file.
-
-To export, use |file-o| **File** > |download| **Export** and select ``.doc`` as the format.
+The :ref:`app_documents` supported format are Microsoft Word ``.docx`` and OpenDocument ``.odt``. These can both be exported from popular software such as Google Docs and LibreOffice Writer:
 
-Document import/export
-~~~~~~~~~~~~~~~~~~~~~~
-
-To import documents, the supported format are Microsoft Word ``.docx`` and OpenDocument ``.odt``. These can both be exported from popular software such as Google Docs and LibreOffice Writer:
-
-1. Export your document as ``.docx`` or ``.odt`` in your existing software.
-2. Save the file to your computer.
-3. Open a new :ref:`app_documents` file (or an existing one to replace the contents).
-4. |file-o| **File** > |upload| **Import** and select your file.
+1. Export your document as ``.docx`` or ``.odt`` in your existing software
+2. Save the file to your computer
+3. Open a new :ref:`app_documents` file (or an existing one to replace the contents)
+4. |file-o| **File** > |upload| **Import** and select your file
 
 To export, use |file-o| **File** > |download| **Export** and choose a format:
 
-- To use in Microsoft Word or Google Docs, select ``.docx``.
-- To use in LibreOffice Writer, select ``.odt``.
-- For cases where no further editing of the data is required after export (letters, reports, etc), select ``.pdf``.
-- For backup purposes or to share with a user on another CryptPad instance, select ``.bin``.
+- To use in Microsoft Word or Google Docs, select ``.docx``
+- To use in LibreOffice Writer, select ``.odt``
+- For cases where no further editing of the data is required after export (letters, reports, etc), select ``.pdf``
+- For backup purposes or to share with a user on another CryptPad instance, select ``.bin``
 
-Presentation import/export
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Presentation application import/export
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To import presentations, the supported format are Microsoft PowerPoint ``.pptx`` and OpenDocument ``.odp``. These can both be exported from popular software such as Google Slides and LibreOffice Impress:
+The :ref:`app_presentation` supported format are Microsoft PowerPoint ``.pptx`` and OpenDocument ``.odp``. These can both be exported from popular software such as Google Slides and LibreOffice Impress:
 
-1. Export your document as ``.pptx`` or ``.odp`` in your existing software.
-2. Save the file to your computer.
-3. Open a new :ref:`app_presentation` document (or an existing one to replace the contents).
-4. |file-o| **File** > |upload| **Import** and select your file.
+1. Export your document as ``.pptx`` or ``.odp`` in your existing software
+2. Save the file to your computer
+3. Open a new :ref:`app_presentation` document (or an existing one to replace the contents)
+4. |file-o| **File** > |upload| **Import** and select your file
 
 To export, use |file-o| **File** > |download| **Export** and choose a format:
 
-- To use in Microsoft PowerPoint or Google Slides, select ``.pptx``.
-- To use in LibreOffice Impress, select ``.odp``.
-- For cases where no further editing of the data is required after export (presentations, reports, etc), select ``.pdf``.
-- For backup purposes or to share with a user on another CryptPad instance, select ``.bin``.
+- To use in Microsoft PowerPoint or Google Slides, select ``.pptx``
+- To use in LibreOffice Impress, select ``.odp``
+- For cases where no further editing of the data is required after export (presentations, reports, etc), select ``.pdf``
+- For backup purposes or to share with a user on another CryptPad instance, select ``.bin``
 
-Spreadsheets import/export
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Spreadsheet application import/export
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To import spreadsheets, the supported format are Microsoft Excel ``.xlsx`` and OpenDocument ``.ods``. These can both be exported from popular software such as Google Sheets and LibreOffice Calc:
+The :ref:`app_sheets` supported format are Microsoft Excel ``.xlsx`` and OpenDocument ``.ods``. These can both be exported from popular software such as Google Sheets and LibreOffice Calc:
 
-1. Export your document as ``.xlsx`` or ``.ods`` in your existing software.
-2. Save the file to your computer.
-3. Open a new :ref:`app_sheets` document (or an existing one to replace the contents).
-4. |file-o| **File** > |upload| **Import** and select your file.
+1. Export your document as ``.xlsx`` or ``.ods`` in your existing software
+2. Save the file to your computer
+3. Open a new :ref:`app_sheets` document (or an existing one to replace the contents)
+4. |file-o| **File** > |upload| **Import** and select your file
 
 To export, use |file-o| **File** > |download| **Export** and choose a format:
 
 .. .csv commented out as it's broken and deactivated
 .. - The ``.csv`` format is the most widely supported (note that it only contains data and not formatting).
 
-- To use in Microsoft Excel or Google sheets, select ``.xlsx``.
-- To use in LibreOffice Calc, select ``.ods``.
-- For cases where no further editing of the data is required after export (presentations, reports, etc), select ``.pdf``.
-- For backup purposes or to share with a user on another CryptPad instance, select ``.bin``.
+- To use in Microsoft Excel or Google sheets, select ``.xlsx``
+- To use in LibreOffice Calc, select ``.ods``
+- For cases where no further editing of the data is required after export (presentations, reports, etc), select ``.pdf``
+- For backup purposes or to share with a user on another CryptPad instance, select ``.bin``
 
-.. note::
-    Import/export of OnlyOffice documents to various formats is only available in browsers that support specific functionality. Please see the `up-to-date list of supported browsers <https://caniuse.com/sharedarraybuffer>`_.
+Rich text application import/export
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The :ref:`app_rich_text` support the HTML format for import/export:
+
+1. Export your document as HTML in your existing software
+2. Save the file to your computer
+3. Open a new :ref:`app_rich_text` document on CryptPad (or an existing one to replace the contents)
+4. |file-o| **File** > |upload| **Import** and select your file
+
+To export, use |file-o| **File** > |download| **Export** and select ``.doc`` as the format.
 
 I cannot do X with a document I created
 ---------------------------------------
 
 Some functionality on CryptPad is restricted to :ref:`document owners <owners>`. This includes:
 
--  Enabling an :ref:`access list <access_list>`.
--  Enabling a password.
--  Adding or removing other owners.
--  Destroying the document.
+-  Enabling an :ref:`access list <access_list>`
+-  Enabling a password
+-  Adding or removing other owners
+-  Destroying the document
 
 The ownership of a document is set when :ref:`creating it<new_document>` and cannot be changed afterwards if the document is created without an owner.
 
@@ -160,9 +162,9 @@ Are you planning to make an app?
 
 We are not planning a dedicated mobile application for the following reasons:
 
-- It would dramatically increase the amount of code that has to be developed and maintained, effectively creating other "versions" of CryptPad for iOS and Android.
+- It would dramatically increase the amount of code that has to be developed and maintained, effectively creating other "versions" of CryptPad for iOS and Android
 
-- CryptPad is open source and can be hosted by anyone who wants to offer the service. Therefore, users of a mobile application would have to specify which :ref:`CryptPad instance <cryptpad_instances>` they want to connect to, which would be confusing. To complicate things further, each instance may be running a different version of the software, depending on whether or not the latest updates were applied by the administrators.
+- CryptPad is open source and can be hosted by anyone who wants to offer the service. Therefore, users of a mobile application would have to specify which :ref:`CryptPad instance <cryptpad_instances>` they want to connect to, which would be confusing. To complicate things further, each instance may be running a different version of the software, depending on whether or not the latest updates were applied by the administrators
 
 To address these problems, the development team is working on making CryptPad a "Progressive Web App". This means that it can be used on mobile through the web browser, behaving like an application while being the same software that runs on desktop browsers. This has the benefit of turning every CryptPad instance into a web app provider, rather than putting the burden of choosing the right instance on the user.