Editing an Existing Page

Editing an existing page is perhaps the easiest way to get started working with the content. To facilitate this, most pages have an "Improve this page" link at the bottom of the page.

To edit a page:

  1. Find the page on the portal.
  2. Scroll to the bottom of the page and locate the "Improve this page" link there.
  3. Select the link which will take you the page's markdown file in github on the staging branch.
  4. Edit the page using the github markdown editor.
  5. Preview the page using the github markdown editor.
  6. Submit a pull request to have your updates merged into the staging branch of the repository.
Edit an Existing Page

Figure 1: Using the "Improve this page" link to locate the page's source file in github.

Editing with the Github Markdown Editor

Once you have found the page in github, you can edit and do a basic preview of the page in github. To do this, click on the edit icon on the right hand side of the github markdown page.

Selecting the edit button will open the file in the github web editor and let you make changes to the page content. The page content is in standard markdown.

Edit an Existing Page

Figure 2: Using the github web editor to modify the source file's markdown.

Modifying Front Matter

At the top of the file you will see a "Front Matter" sections between the --- markers. Here you can change the Title and Publication Date of the document or the URL to the document in the site.

    ---
    title: "Example Page"
    author: "Mary Marple"
    ---

Previewing Updates

Once in the editor, you can update content as you like and even preview the markdown by selecting the "Preview Changes" tab.

The preview will be styled for the github site, not for the HCA site, but you can see if your image links work and check general formatting of the document.

Note that the github editor does not highlight spell check errors so be vigilant.

Edit in Github

Figure 3: Using the github preview changes feature to view a diff of your changes against the original content.

Creating a Pull Request

Once you are ready, request a review from a peer, by creating a pull request in github using the pull request UI at the bottom of the edit or preview mode editor.

Once your pull request is merged it will be deployed to the site.

Create a Pull Request

Figure 4: Creating a pull request with the github interface.

Improve this pageContent guide