Skip to content

Commit

Permalink
Merge pull request #173 from learningequality/release-v0.13.x
Browse files Browse the repository at this point in the history 
release-v0.13.x into develop
  • Loading branch information
Benjamin Balder Bach committed Apr 28, 2020
2 parents cdd0806 + de2d30e commit 3ef3558
Show file tree
Hide file tree
Showing 11 changed files with 5,849 additions and 3,079 deletions.
97 changes: 41 additions & 56 deletions docs/faq.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,32 +5,39 @@ Frequently Asked Questions
How much does Kolibri cost to install?
--------------------------------------

Kolibri is **free and open source** software! To learn more about free software, see this `Free Software Foundation article <https://www.fsf.org/about/what-is-free-software>`_.
Kolibri is `free and open-source <https://www.fsf.org/about/what-is-free-software>`_ software!


Do I need the internet to run Kolibri?
--------------------------------------

Short answer: **No!** You can bring or send a storage device (USB or HDD unit) with Kolibri installer and content channels downloaded somewhere with available internet connection, and install everything on an completely offline device.
**No!** You can bring or send a storage device (USB or HDD unit) with Kolibri installer and content channels downloaded somewhere with available internet connection, and install everything on an completely offline device.

In a nutshell, Kolibri can run independently of internet availability, but you need to procure the installer and content channels from somewhere for the initial installation and for subsequent upgrades.
In a nutshell, Kolibri can run independently of internet availability, but you need to procure the installer and content channels from somewhere for the initial installation and for subsequent upgrades.

One possibility is to have Kolibri installed in one location with internet connection, where you can import content channels from `Kolibri Studio <https://studio.learningequality.org/>`_ (curriculum tool and content curation server), and then export them to removable USB drives that you bring or send to offline locations (rural schools, refugee camps, etc.) to import locally.

.. _languages:


How do I get help if something isn't working?
---------------------------------------------

Please refer to the :ref:`Troubleshoot and Support <support>` section of this guide.


What languages is Kolibri available in?
---------------------------------------

Both Kolibri and `Kolibri Studio <https://studio.learningequality.org/>`_ are translation-ready and currently available in these languages:

+---------------------------+-----------------+-----------------+
| Language | Kolibri | Kolibri Studio |
+===========================+=================+=================+
+---------------------------+-----------------+-----------------+
| Language | Kolibri | Kolibri Studio |
+===========================+=================+=================+
| English | ✓ | ✓ |
+---------------------------+-----------------+-----------------+
| Arabic | ✓ | |
+---------------------------+-----------------+-----------------+
+---------------------------+-----------------+-----------------+
| Bengali | ✓ | |
+---------------------------+-----------------+-----------------+
| Bulgarian | ✓ | |
Expand All @@ -45,9 +52,11 @@ Both Kolibri and `Kolibri Studio <https://studio.learningequality.org/>`_ are tr
+---------------------------+-----------------+-----------------+
| Fulfulde Mbororoore | ✓ | |
+---------------------------+-----------------+-----------------+
| Gujarati | ✓ | |
+---------------------------+-----------------+-----------------+
| Hindi (India) | ✓ | |
+---------------------------+-----------------+-----------------+
| Gujarati | ✓ | |
| Italian | ✓ | |
+---------------------------+-----------------+-----------------+
| Korean | ✓ | |
+---------------------------+-----------------+-----------------+
Expand All @@ -56,7 +65,7 @@ Both Kolibri and `Kolibri Studio <https://studio.learningequality.org/>`_ are tr
| Portuguese (Brazil) | ✓ | |
+---------------------------+-----------------+-----------------+
| Spanish (Latin America) | ✓ | ✓ |
+---------------------------+-----------------+-----------------+
+---------------------------+-----------------+-----------------+
| Spanish (Spain) | ✓ | |
+---------------------------+-----------------+-----------------+
| Swahili (Tanzania) | ✓ | |
Expand All @@ -72,89 +81,65 @@ Both Kolibri and `Kolibri Studio <https://studio.learningequality.org/>`_ are tr

To contribute to Kolibri and Kolibri Studio as a translator, you can get started over on our `translations and internationalization page <https://learningequality.org/translate/>`_.

What are the typical deployment scenarios?
------------------------------------------
What are some typical implementation scenarios?
-----------------------------------------------

There is no typical implementation setting. However, we can share with you what we’ve learned from our community of KA Lite and Kolibri users. Some example implementation settings are provided below based on the presence of a coach and whether the settings allows for formal, non-formal, and informal learning.

+---------------------------+-----------------------------------+--------------------------------------------------------------------------------+
| | Coach | No Coach |
+===========================+===================================+================================================================================+
+---------------------------+-----------------------------------+--------------------------------------------------------------------------------+
| | Coach | No Coach |
+===========================+===================================+================================================================================+
| Formal and Non-Formal | * School classroom | * After school program |
| | * Home schooling | * Supplementary education setting (computer labs model) |
| | * Supplementary education setting | * Use in classroom that has teacher, but without coach engagement or monitoring|
| | | |
+---------------------------+-----------------------------------+--------------------------------------------------------------------------------+
+---------------------------+-----------------------------------+--------------------------------------------------------------------------------+
| Informal | * Tutoring session | * Mobile school vans |
| | | * Use for homework only |
+---------------------------+-----------------------------------+--------------------------------------------------------------------------------+


What are some possible hardware configurations for deploying Kolibri?
---------------------------------------------------------------------
What are some possible hardware configurations?
-----------------------------------------------

To deploy Kolibri for multiple users you will need:
To implement Kolibri for multiple users you will need:

#. **Server device**: a computer that is running the Kolibri software (e.g. a desktop computer, laptop, or Raspberry Pi).
#. One or more **client devices** that have web browsers (laptops, tablets, desktop computers, etc)

.. note::
For a single-device deployment (1) and (2) can be the same computer, with the browser connecting to the locally running Kolibri server. To make the software accessible to multiple client devices, you will need to put them on the same local network as the Kolibri server device (1), e.g. through a WIFI access point.
For a single-device implementation (1) and (2) can be the same computer, with the browser connecting to the locally running Kolibri server. To make the software accessible to multiple client devices, you will need to put them on the same local network as the Kolibri server device (1), e.g. through a WIFI access point.

To read more details, see the full `Kolibri Hardware Guide <https://learningequality.org/r/hardware-guide>`_ and examples of `Hardware Configurations for Kolibri <https://learningequality.org/r/hardware>`_ (PDF documents).


How can I generate content aligned to local curriculum?
-------------------------------------------------------

Use `Kolibri Studio <https://studio.learningequality.org/>`_ curriculum tool to curate content channels aligned to your local requirements. Once you finish creating the channels on Studio, you can import them on all your Kolibri deployments for use in learning environments.
How can I aligned resources to local curricula?
-----------------------------------------------

Use `Kolibri Studio <https://studio.learningequality.org/>`_ curriculum tool to curate content channels aligned to your local requirements. Once you finish creating the channels on Studio, you can import them on all your Kolibri implementations for use in learning environments.

Bulk Downloads of Content Channels
----------------------------------

``Coming soon!``
Who maintains Kolibri?
----------------------

At this time we do not support bulk downloads of content channel outside the Kolibri platform. In the near future, we will consider offering bit torrents for certain global content channels.
Kolibri is created, maintained, and operated by `Learning Equality <https://learningequality.org/>`_.


Something isn’t working!
------------------------

Refer to the :ref:`Troubleshoot and Support <support>` section of this guide.


Who maintains the Kolibri project?
----------------------------------

Kolibri is created, maintained, and operated by `Learning Equality <https://learningequality.org/about/>`_.
To stay up-to-date on all our activities, follow our `blog <https://blog.learningequality.org/>`_, `Twitter <https://twitter.com/LearnEQ/>`_, and `Facebook <https://www.facebook.com/learningequality>`_!


How do you operate in the field?
--------------------------------
How are Kolibri implementations operated?
-----------------------------------------

The Learning Equality team primarily works in our San Diego offices, building software and shaping our road map based on our interactions with our partners around the world. We work with individual humanitarians and NGOs of all sizes to help them distribute Kolibri to offline communities around the world, and will work on site for research and training purposes.


What is Kolibri’s affiliation with Khan Academy?
------------------------------------------------

Kolibri is an independent, open-source project maintained by `Learning Equality <https://learningequality.org/about/>`_, and is not officially affiliated with Khan Academy, although they are very supportive of the Kolibri project.

Kolibri is an independent, open-source project maintained by `Learning Equality <https://learningequality.org/>`_, and is not officially affiliated with Khan Academy, although they are very supportive of the Kolibri project.

Can I contribute to Kolibri as a developer?
-------------------------------------------

Yes! Kolibri is an `open source project <https://github.com/learningequality/>`_, and developers are encouraged to contribute!
Can I contribute to Kolibri?
----------------------------


Can I contribute to Kolibri as a translator?
--------------------------------------------

Yes, absolutely! To contribute to Kolibri and Kolibri Studio as a translator, you can get started over on our `translations and internationalization page <https://learningequality.org/translate/>`_.


How do I find out more about Learning Equality and Kolibri?
-----------------------------------------------------------

To stay up-to-date on all our activities, follow our `blog <https://blog.learningequality.org/>`_, `Twitter <https://twitter.com/LearnEQ/>`_, and `Facebook <https://www.facebook.com/learningequality>`_!
Yes, `contributions are welcome <https://kolibri-dev.readthedocs.io/en/develop/contributing/ways_to_contribute.html>`_! We can use help with feedback, bug reports, software development, and translations.

0 comments on commit 3ef3558

Please sign in to comment.