Method 1: Edit an existing page from website

  1. Create a free GitHub account, if you do not already have one.
  2. Click Edit this page on GitHub in the bottom right of any webpage on gis.utah.gov.
    Edit this page on GitHub
  3. You will be brought to a page where you can propose a file change to the webpage.
    1. By proposing a file change using this method, GitHub will automatically create your own local version of the AGRC Website, or a “fork”, in your GitHub account.
    2. The fork will contain a branch called Patch-1.
  4. Edit the file in GitHub window.
    1. Files are either in html or markdown. Check the file extension.
  5. When finished with the edits, please write a summary of what was edited, added, or deleted under Propose file change.
  6. Click the Propose file change green button.
    Propose Edit
  7. You will be brought to a new screen. Click the Create pull request green button.
    Create Pull Request
  8. If you only have one edit, the change summary will be autocompleted. Otherwise, write a summary of all edits.
  9. Click the Create pull request green button.
    Create Pull Request
  10. Congratulations! You contributed!

Method 2: Editing a page from within the AGRC Website GitHub repository

  1. Create a free GitHub account, if you do not already have one.
  2. Go to the AGRC website repository on GitHub: https://github.com/agrc/gis.utah.gov.
  3. You’ll need to create your own “fork”, or version, of the website repository. To do this, click Fork in the upper right. Then, click your GitHub username.
  4. Navigate to the page you wish to edit.
    1. Blogposts are in the _posts folder.
    2. Data pages are in the data folder.
  5. Click the pencil icon in the upper right to edit the webpage.
    1. Files are either in html or markdown.
  6. When finished with edit, please write a summary of what was edited, added, or deleted under Commit changes.
  7. Click the Commit changes green button.
  8. Repeat steps 4-6 until you are done with your edits for the time being.
  9. Create a pull request, to request the edits be pulled to the master.
    Create Pull Request From Repository
    1. Click the Pull Requests tab under username/agrc.github.io in the upper left.
    2. Click the New pull request green button.
    3. Click the Create pull request green button.
      Create Pull Request From Repository
    4. Write a summary of your edits.
    5. Click the Create pull request green button.
      Create Pull Request From Repository
  10. Congratulations! You contributed!

Important note if you return to make edits at a later date:

  1. In order to not create conflicts between website versions, you need to delete your repository and then create a new fork.
  2. Migrate to your repository: https://github.com/username/gis.utah.gov
  3. Click the Settings tab for your repository.
  4. Scroll to the Danger Zone at the bottom. Click the Delete this repository button. Danger Zone
  5. Now you are free to go create a new fork and keep on editing!