7
0
mirror of https://github.com/ChristianLight/tutor.git synced 2024-06-01 22:00:48 +00:00
tutor/docs/index.rst

65 lines
2.8 KiB
ReStructuredText
Raw Normal View History

.. Tutor documentation master file, created by
sphinx-quickstart on Mon Dec 3 21:36:51 2018.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
2018-12-26 15:00:47 +00:00
Tutor 🎓 Open edX 1-click install for everyone
==============================================
.. image:: https://img.shields.io/travis/regisb/tutor.svg
:alt: Build status
:target: https://travis-ci.org/regisb/tutor
.. image:: https://img.shields.io/github/issues/regisb/tutor.svg
:alt: GitHub issues
:target: https://github.com/regisb/tutor/issues
.. image:: https://img.shields.io/github/issues-closed/regisb/tutor.svg?colorB=brightgreen
:alt: GitHub closed issues
:target: https://github.com/regisb/tutor/issues?q=is%3Aclosed
2018-12-26 15:00:47 +00:00
**Tutor** is a one-click install of `Open edX <https://openedx.org>`_, both for production and local development, inside docker containers. Tutor is easy to run, fast, full of cool features, and it is already used by dozens of Open edX platforms in the world.
2018-12-27 01:49:12 +00:00
.. image:: https://asciinema.org/a/octNfEnvIA6jNohCBmODBKizE.png
:alt: asciicast
2018-12-27 01:49:12 +00:00
:target: https://asciinema.org/a/octNfEnvIA6jNohCBmODBKizE
----------------------------------
2018-12-26 15:00:47 +00:00
.. include:: quickstart.rst
:start-line: 1
2018-12-26 15:00:47 +00:00
For more advanced usage of Tutor, please refer to the following sections.
.. toctree::
:maxdepth: 2
:caption: User guide
2018-12-26 15:00:47 +00:00
quickstart
requirements
local
k8s
options
customise
dev
troubleshooting
missing
2018-12-26 15:00:47 +00:00
tutor
Disclaimers & Warnings
----------------------
This project is the follow-up of my work on an `install from scratch of Open edX <https://github.com/regisb/openedx-install>`_. It does not rely on any hack or complex deployment script. In particular, we do not use the Open edX `Ansible deployment playbooks <https://github.com/edx/configuration/>`_. That means that the folks at edX.org are *not* responsible for troubleshooting issues of this project. Please don't bother Ned ;-)
2018-12-26 15:00:47 +00:00
In case of trouble, please follow the instructions in the :ref:`troubleshooting` section.
Contributing
------------
We go to great lengths to make it as easy as possible for people to run Open edX inside Docker containers. If you have an improvement idea, feel free to `open an issue on Github <https://github.com/regisb/tutor/issues/new>`_ so that we can discuss it. `Pull requests <https://github.com/regisb/tutor/pulls>`_ will be happily examined, too! However, we should be careful to keep the project lean and simple: both to use and to modify. Optional features should not make the user experience more complex. Instead, documentation on how to add the feature is preferred.
License
-------
2019-01-16 16:22:53 +00:00
This work is licensed under the terms of the `GNU Affero General Public License (AGPL) <https://github.com/regisb/tutor/blob/master/LICENSE.txt>`_.