.. _edit_a_lesson_ref:

=============
Edit a lesson
=============

In this article, you will learn how to:

* :ref:`edit_a_lesson_in_the_exploration_editor_ref`
* :ref:`edit_a_card_in_the_exploration_overview_ref`
* :ref:`save_lesson_drafts_ref`
* :ref:`delete_a_card_ref`
* :ref:`delete_an_exploration_ref`

.. _edit_a_lesson_in_the_exploration_editor_ref:

Edit a lesson in the Exploration Editor
=======================================

1. Select your profile photo in the top right corner of any page.
2. Select **Creator Dashboard** from the dropdown menu.
3. Select the lesson you would like to edit. This will open the
   **Exploration Editor**.

.. _edit_a_card_in_the_exploration_overview_ref:

Edit a card in the Exploration Overview
=======================================

1. Select the card from the panel. The card’s content will appear left of the
   **Exploration Overview**.

.. figure:: /images/creators/exploration_overview_edit.png
   :alt: The Exploration Overview panel showing a map of cards used to navigate and select specific parts of the lesson.

   *Fig. 1. Use the Exploration Overview to edit cards*

2. Select **Edit** (pen icon) to edit the content.
3. Select **Save Content**.

.. figure:: /images/creators/edit_card_content_icon.png
   :alt: Close up of the pen icon used to open the text editor for a specific card.

   *Fig. 2. Edit icon in the card editor*

.. _save_lesson_drafts_ref:

Save lesson drafts
==================

Every time you save an exploration, Oppia keeps a record of that version. You
can revisit, edit, and revert to any previous version you’ve saved.

To save a draft of your exploration:

1. Select **Save Draft** in the **Exploration Editor**.
2. In the dialog box that appears, enter notes about the changes you’ve made.
3. Select **Save**.
   * Select **History** to view a list of all saved versions.

.. figure:: /images/creators/save_draft_dialog.png
   :alt: The Save Draft dialog box where creators can enter commit messages describing their changes.

   *Fig. 3. Save Draft dialog*


Revert to a previously saved version
------------------------------------

.. figure:: /images/creators/list_of_changes_history.png
   :alt: The History tab showing a chronological list of saved versions and changes made by contributors.

   *Fig. 4. List of Changes panel includes all saved versions*

To return to an earlier version of your exploration:

1. Select **History** (the clock icon).
2. Find the version you want to revert to.
3. Select **...** next to that version and select **Revert** on the dropdown menu.

.. note::
   Reverting to a previous version will discard any unsaved changes in your
   current draft. If you want the option to return to your current version later,
   make sure to save your draft before reverting.


Compare selected versions
-------------------------

To compare two versions of the same lesson:

1. On the **History** page, scroll to the **Compare Revisions** panel.
2. From the **Revisions** dropdown menu, select the two numbered drafts you
   would like to compare.

The changes appear in the panel below, along with a legend to help you navigate
each change.

.. figure:: /images/creators/compare_revisions_panel.png
   :alt: The Compare Revisions interface showing a side-by-side comparison of two lesson versions with highlighted differences.

   *Fig. 5. Compare Revisions panel*


Review card errors
------------------

If you see a warning icon on a card in the **Exploration Overview**, there’s an
error with the card. This could be an issue with the question, response, or the
interaction logic. You must fix the error before publishing the exploration.

To find out what needs to be fixed, hover over the warning icon. A message will
appear explaining the issue.

.. figure:: /images/creators/card_warning_icons.png
   :alt: Warning icons appearing on cards in the overview map indicating logic or content errors that need resolution.

   *Fig. 6. Warning icons on cards*


.. _delete_a_card_ref:

Delete a card
=============

To delete a card from the exploration, select the **x** icon in the corner of
the card in the **Exploration Overview** panel.

.. figure:: /images/creators/delete_card_icon.png
   :alt: The Exploration Overview panel highlighting the 'x' button on a card node to remove it.

   *Fig. 7. Delete a card from an exploration*


.. _delete_an_exploration_ref:

Delete an exploration
=====================

To delete an exploration:

1. Select **Creator Dashboard** from your profile, and select the Exploration
   you want to delete.
2. Select **Settings** (gear icon) in the **Exploration Editor**.
3. Scroll to the **Controls** panel at the bottom of the page.
4. Select **Delete Exploration**.

.. figure:: /images/creators/controls_panel_delete.png
   :alt: The Controls panel at the bottom of the Settings page with the red Delete Exploration button.

   *Fig. 7. Controls panel*