Skip to content

Latest commit

 

History

History
83 lines (55 loc) · 2.85 KB

edit-file.rst

File metadata and controls

83 lines (55 loc) · 2.85 KB

Edit a file

Each page of the published documentation on Read The Docs is maintained in a file in the GitHub repository for the documentation set.

The :doc:`Register page <register>` that contains a list of all the people who have done this tutorial is one of those.

In the following steps you will add yourself to that page, by editing the reStructuredText source file.

Make and propose changes in a file

  1. Open https://github.com/evildmp/sphinx-rst/blob/master/register.rst.

  2. Select the Edit icon to Fork this project and edit the file (if you don't see it, you're not logged in):

    Fork this project and edit this file
  3. Select Create a new branch for this commit and start a pull request.

  4. Add a new entry at the bottom of the list containing the date and a link to your GitHub username (and optionally your own name). Follow the pattern of existing entries:

    * YYYY-MM-DD `username <https://github.com/username>`_ Your Name
    

    (Note the underscore at the end of the hyperlink markup.)

  5. Make sure the file ends with a blank line.

  6. Select the Propose changes button.

This will create a fork of the documentation repository in your own GitHub account.

Make a pull request

The next step is to create a pull request - a request to the maintainers to pull the changes from the branch you've just created: select Create pull request.

As soon as you create the pull request, Read The Docs will start rebuilding the site. In a few seconds, the build should be complete. Select Build details to see the version of the documentation that has just been built for you.

Build details

Check that your changes in the Register page of your build look correct.

You can also see the full list of recent builds.

Read The Docs will show any build errors - if this happens; you'll have to check your changes and edit the file again.

I will then need to merge your pull request into the repository - it requires my approval.

Once it has been merged, your changes will become part of the source code of this website. The newly-updated :doc:`Register page <register>` will contain your entry.

What's next

This is all you need in order to contribute to documentation that's maintained in Git, written in reStructuredText, published using Sphinx and hosted on Read the Docs.

It's good enough for lightweight maintenance and small fixes. For more substantial documentation contributions, it's much more effective to work locally - writing, building and testing the documentation - then to push work to the Git repository.

The next section covers the elements of that workflow, step-by-step.