Open edX Documentation
######################

.. The homepages are provided as links in the panels so we don't need to display
   the table of contents for them.

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 0

   .. grid-item-card:: 📰 What's New?
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. toctree::
         :maxdepth: 1
         :hidden:

         📰 What's New? <community/release_notes/ulmo/ulmo_marketing_notes>

      The Open edX Ulmo release is out, featuring:

      🔔 Platform & Email Notifications!

      📚 Section Reuse and Granular Permissions with Libraries!

      🚀 Reusable LTI Configuration!

      ... and lots more! :ref:`Continue reading... <Ulmo Product Marketing Notes>`

   .. grid-item-card::
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0
      
      .. toctree::
         :maxdepth: 1
         :caption: Quick Starts

         Set up an Open edX Site <site_ops/quickstarts/index>
         Build an Open edX Course <educators/quickstarts/build_a_course>
         Contribute to the Open edX Code Base <developers/quickstarts/so_you_want_to_contribute>
         Update the Open edX Documentation <documentors/quickstarts/first_documentation_pr>

.. toctree::
   :maxdepth: 1
   :caption: Role Guides
   :hidden:

   Community <community/index>
   Educators <educators/index>
   Learners <learners/index>
   Site Operators <site_ops/index>
   Developers <developers/index>
   Documentors <documentors/index>
   Translators <translators/index>


**************************
Role Guides
**************************

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 0

   .. grid-item-card:: Educators
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/educators_homepage/educator_undraw.png
         :alt: Educator Persona building a course
         :height: 150px
         :align: center

      Build, run and analyze courses on the Open edX® Platform.

      +++
      .. button-ref:: educators/index
         :color: primary
         :outline:
         :expand:

         Educators' Home

   .. grid-item-card:: Learners
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/learner_undraw.png
         :alt: Learner Persona learning
         :height: 150px
         :align: center

      Learn and engage with Open edX® courses.

      +++
      .. button-ref:: learners/index
         :color: primary
         :outline:
         :expand:

         Learners' Home

   .. grid-item-card:: Site Operators
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/site_operators_undraw.png
         :alt: Site Operator Persona operating a site
         :height: 150px
         :align: center

      Deploy and run an Open edX® site.

      +++
      .. button-ref:: site_ops/index
         :color: primary
         :outline:
         :expand:

         Site Operators' Home

   .. grid-item-card:: Software Developers
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/developers_undraw.png
         :alt: Developer Persona enhancing the platform
         :height: 150px
         :align: center

      Enhance and extend the Open edX® Platform.

      +++
      .. button-ref:: developers/index
         :color: primary
         :outline:
         :expand:

         Developers' Home

   .. grid-item-card:: Documentors
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/documentors_undraw.png
         :alt: Documentor Persona documenting the platform
         :height: 150px
         :align: center

      Document the Open edX® Platform.

      .. toctree::
         :maxdepth: 1
         :hidden:

      +++
      .. button-ref:: documentors/index
         :color: primary
         :outline:
         :expand:

         Documentors' Home

   .. grid-item-card:: Translators
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/translators_undraw.png
         :alt: Translator Persona translating the platform
         :height: 150px
         :align: center

      Translate the Open edX® Platform.

      +++
      .. button-ref:: translators/index
         :color: primary
         :outline:
         :expand:

         Translators' Home


.. toctree::
   :maxdepth: 1
   :caption: Core Contributors Handbook
   :hidden:

   handbook/index

**************************
Core Contributors Handbook
**************************

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 0

   .. grid-item-card:: Core Contributors Handbook
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/handbook_undraw.png
         :alt: Core Contributor Persona contributing to the platform
         :height: 150px
         :align: center

      A central guide for all current and aspiring Core Contributors to the Open edX project

      +++
      .. button-ref:: handbook/index
         :color: primary
         :outline:
         :expand:

         Core Contributors' Handbook

**************************
Open edX Release Notes
**************************

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 0

   .. grid-item-card::
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. image:: /_images/trees_undraw.png
         :alt: Abstract tree with branches
         :height: 150px
         :align: center

      Release notes for the latest and all previous releases of the Open edX Platform. Our releases are named after trees!

      .. toctree::
         :maxdepth: 1
         :caption: Open edX Release Notes

         Current Release: Ulmo <community/release_notes/ulmo>
         All Release Notes <community/release_notes/index>

**************************
Help & Feedback
**************************

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 0

   .. grid-item-card::
      :class-card: sd-shadow-md sd-p-2
      :class-footer: sd-border-0

      .. toctree::
         :maxdepth: 1
         :caption: Help & Feedback

         Provide Feedback on these Docs <other/feedback>
         Get Help with Open edX <other/getting_help>