Update An Existing Doc via GitHub#

This how-to will take you through the process of submitting an update to a page that you are looking at within the Open edX documentation.

Prerequisites#

  • You’re on the published documentation page at some address like docs.openedx.org/... and you want to make changes to it.

  • You have a GitHub Account

  • In the GitHub UI, make any edits you need to make.

1. Edit a file#

  1. On the page you want to edit, find the suggest edit link.

    ../../_images/suggest_edit_link.png
  2. Make the necessary changes.

    Ensure you adhere to RST standards in the file. See the Quick Reference: Writing RST for a quick RST reference.

  3. In the Commit Changes section at the bottom of the edit window:

    1. Add a descriptive comment about the changes you made.

    2. Click Propose changes to save these changes to your branch.

      ../../_images/edit_in_github.png

2. Create a Pull Request#

When you are ready to have the Open edX team review your proposed documentation changes, you create a pull request.

  1. Once you have clicked the Propose changes button, click Create pull request.

    ../../_images/create_pr_screen1.png
  2. On the next screen, give your pull request a unique, descriptive title and add a full description of your changes.

  3. Click Create pull request button again to complete submitting your changes. Please make sure the “Allow edits by maintainers” checkbox is checked - this enables the Open edX team to rerun tests or make small changes, which will decrease the time for your changes to be accepted.

    ../../_images/create_pr_screen2.png

The Open edX team will then review your changes. If they approve, they will merge the pull request, and you will see your changes in the latest documentation. The Open edX team may ask you to make further changes, to clarify the documentation or fix issues. See Make Changes to your Pull Request if you’d like a refresher on how to make changes to your existing pull request.