How to Edit Existing Content on gis.utah.gov

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.
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 UGRC 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.
7. You will be brought to a new screen. Click the Create pull request green button.
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.
10. Congratulations! You contributed!

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

1. Create a free GitHub account, if you do not already have one.
2. Go to the UGRC 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 in the upper right. Then, click your GitHub username.
4. Navigate to the page you wish to edit.
   1. Blog posts 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.
   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.
   4. Write a summary of your edits.
   5. Click the Create pull request green button.
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. Browse 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.
5. Now you are free to go create a new fork and keep on editing!