Merge pull request #155 from learningequality/release-v0.13.x

Release v0.13.x -> Develop

docs/access/index.rst

@@ -14,7 +14,7 @@ Steps to access and start the **Kolibri** server will differ depending on your o
   rpi
   macos
 
-Remember to configure other devices in the the same network to access the the learning resources on the server.
+Remember to configure other devices in the the same network to access the learning resources on the server.
 
 .. toctree::
   :maxdepth: 1

docs/access/macos.rst

@@ -3,16 +3,19 @@
 MacOS
 #####
 
-To start the **Kolibri** server on macOS, double-click the Kolibri app from the **Launchpad**. 
+#. **The first time you start the Kolibri application, do NOT use Launchpad**. Instead use the **Finder** on your Mac to locate Kolibri in the **Applications** folder. This is because the application is unsigned and needs your permission to run.
 
-.. TO-DO (image)
+#. Control-click the app icon, then choose **Open** from the shortcut menu.
+
+   After completing these steps, your security settings are updated for this version of Kolibri, and you can launch Kolibri like any other application. You may need to repeat this process when you upgrade Kolibri.
 
-.. note::
-  Remember to :ref:`configure other computers <access_LAN>` in the network to access **Kolibri** content.
 
-.. warning::
-  * Kolibri macOS app is not yet signed, `follow these instructions to enable it to start <https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac>`_.
+   .. note:: Read this for `more details about opening unsigned apps <https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac>`_.
 
+.. TO-DO (image)
 
-  * If you are using keyboard navigation on macOS, be sure to `enable 'All Controls' in the 'System Preferences' <https://a11yproject.com/posts/macos-browser-keyboard-navigation/>`_.
+.. warning::
+   If you are using keyboard navigation on macOS, be sure to `enable 'All Controls' in the 'System Preferences' <https://a11yproject.com/posts/macos-browser-keyboard-navigation/>`_.
 
+.. note::
+  Remember to :ref:`configure other computers <access_LAN>` in the network to access **Kolibri** content.

docs/index.rst

@@ -40,81 +40,44 @@ Kolibri can serve high quality education content from several publicly available
 
 
 .. toctree::
-   :maxdepth: 2
    :hidden:
 
    install/index
-
-.. toctree::
-   :maxdepth: 3
-   :hidden:
-
    access/index
-
-.. toctree::
-   :maxdepth: 3
-   :hidden:
-
    manage/index
-
-.. toctree::
-   :maxdepth: 2
-   :hidden:
-
    manage/advanced
-
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
    coach/index
-
-.. toctree::
-   :maxdepth: 2
-   :hidden:
-
    learn
-
-.. toctree::
-   :maxdepth: 2
-   :hidden:
-
    faq
+   contact
 
 
 .. rst-class:: column column2
 
-:ref:`Learners - start here <learn>`
-************************************
+:ref:`Learners and students<learn>`
+***********************************
 
 Whether you are using Kolibri at your school, in a training center or at home, learn how to :ref:`open <access_learner>` it on your device, what kind of :ref:`content and activities <content_types>` can you work with, and how to submit :ref:`quizzes <quizzes>` created by your coaches or tutors.
 
 
 .. rst-class:: column column2
 
-For :ref:`Coaches <coach>` using Kolibri
-****************************************
+:ref:`Coaches and teachers <coach>`
+***********************************
 
 Read how to :ref:`monitor activity and track the progress <track_progress>` of your learners all the way to single answers to particular questions. Create and :ref:`manage different learner groups <manage_groups>`, :ref:`assign lessons <manage_lessons>`, administer :ref:`quizzes <manage_quizzes>` and view reports.
 
 
 .. rst-class:: clearfix row
 
-For :ref:`Admins and Super admins <manage>` of Kolibri 
-******************************************************
+:ref:`Administrators <manage>`
+******************************
 
 Begin by reading how to :ref:`install <install>` and :ref:`start <access>` Kolibri server on the supported platforms, and :ref:`configure other devices <access_LAN>` in the local network to access its content. Proceed on how to :ref:`import content channels <manage_resources_ref>`, create and manage :ref:`users <manage_users_ref>` and :ref:`classes <manage_classes_ref>`. Configure the :ref:`settings for your facility <manage_facility_ref>`, and assign or edit :ref:`permissions <permissions>` for other users. Learn how to work with Kolibri from :ref:`the command line <command_line>`, 
 :ref:`troubleshoot network issues <network>`, and ask for support on our :ref:`Community Forums <contact>`.
 
 Happy learning with Kolibri!
 
 
-
 .. image:: img/kolibri-use-cases.png
   :alt: 
-
-
-.. toctree::
-   :maxdepth: 3
-
-   contact

docs/install/macos.rst

@@ -18,11 +18,16 @@ Install
    .. figure:: /img/copy-app.png
      :alt: 
 
-4. Start the Kolibri app from the **Launchpad**, the **Applications** folder, or **Spotlight**.
-#. Proceed with the :ref:`setup_initial` of your facility. 
+4. a) **The first time you start the Kolibri application, do NOT use Launchpad**. Instead use the **Finder** on your Mac to locate Kolibri in the **Applications** folder. This is because the application is unsigned and needs your permission to run.
 
-.. warning::
-  * Kolibri macOS app is not yet signed, `follow these instructions to enable it to start <https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac>`_.
+   b) Control-click the app icon, then choose **Open** from the shortcut menu.
+
+      After completing these steps, your security settings are updated for this version of Kolibri, and you can launch Kolibri like any other application. You may need to repeat this process when you upgrade Kolibri.
+
+
+      .. note:: Read this for `more details about opening unsigned apps <https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac>`_.
+
+#. Proceed with the :ref:`setup_initial` of Kolibri. 
 
 
 Uninstall

docs/install/raspberry_pi.rst

@@ -6,7 +6,7 @@ Raspberry Pi
 
 Kolibri is tested to work on Raspberry Pi Models **3, 3+, 4 and Zero W**.
 
-Kolibri may also run on Raspberry Pi Model 2, but the above tutorial was not fully intended for that model, since it does not have on-board WiFi.
+Kolibri may also run on Raspberry Pi Model 2, but the platform has not been tested on that model, and it does not have on-board WiFi.
 
 
 Quick start