Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: add sharing instructions and policy refresh #1784

Merged
merged 62 commits into from
Aug 18, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
62 commits
Select commit Hold shift + click to select a range
f97c233
fix: manually adding previous effort
jacobdadams Aug 18, 2021
b0d3ec5
fix: move open data page to policy
jacobdadams Aug 18, 2021
d28ff90
feat: start hammering out new sharing
jacobdadams Aug 18, 2021
79d94cd
fix: separate metadata process from policy
jacobdadams Aug 18, 2021
45b9f29
chore: links, rewording
jacobdadams Aug 18, 2021
4aed797
feat: fix links, feelings
jacobdadams Aug 18, 2021
22f4d19
feat: first shot at process. death by bullets
jacobdadams Aug 18, 2021
370cc2d
chore: the curse of obsessiveness
jacobdadams Aug 18, 2021
960a202
chore: bullet points
jacobdadams Aug 18, 2021
0295f94
fix: narrative > lists
jacobdadams Aug 18, 2021
de3c4a3
chore: formatting and edits
jacobdadams Aug 18, 2021
d722534
feat: remove old sharing page
jacobdadams Aug 18, 2021
bcc4266
chore: tweaks
jacobdadams Aug 18, 2021
eb3bbb7
fix: punctuation/style from Steve
jacobdadams Aug 18, 2021
ad960d5
fix: missed one in the batch
jacobdadams Aug 18, 2021
2a45de3
fix: thumbnail readability
jacobdadams Aug 18, 2021
fbc4c50
chore: lifelines
jacobdadams Aug 18, 2021
36c0970
chore: more tweaks
jacobdadams Aug 18, 2021
45034b2
fix: dates
jacobdadams Aug 18, 2021
b85a6cf
feat: policificate metadata
jacobdadams Aug 18, 2021
6aca550
fix: end-of-day rushes
jacobdadams Jul 27, 2021
2d5fdfd
feat: open data guidelines
jacobdadams Jul 27, 2021
a3138f4
feat: bullet policies
jacobdadams Jul 27, 2021
1900f58
fix: editing policy edits
jacobdadams Jul 27, 2021
21987bf
By small and simple things
jacobdadams Jul 27, 2021
dd5b69e
fix: formatting
jacobdadams Jul 27, 2021
f230c9e
fix: links to policies in process
jacobdadams Jul 27, 2021
34336c6
fix: formatting, minor edits
jacobdadams Jul 27, 2021
9df7288
fix: lies and statistics
jacobdadams Jul 27, 2021
1298f13
chore: reorder policy page by topics
jacobdadams Jul 8, 2021
1628d67
fix: update sharing link on /data
jacobdadams Jul 8, 2021
6ef13aa
fix: break and fix links
jacobdadams Jul 8, 2021
d239a60
feat: nuke old open data policy page
jacobdadams Jul 8, 2021
53c9c1a
question: link rot in old posts?
jacobdadams Jul 8, 2021
8c38694
fix: add sharing top-level link
jacobdadams Jul 8, 2021
f471cfe
fix: eagle eyes
jacobdadams Jul 8, 2021
2f1ccd3
fix: language, proper issue names
jacobdadams Jul 8, 2021
33cf28d
feat: no private data
jacobdadams Jul 8, 2021
6d396fb
feat: sharing diagram, no raster.utah.gov
jacobdadams Jul 8, 2021
fdf6a79
Optimised images with calibre/image-actions
github-actions[bot] Jul 8, 2021
27f8bac
Apply suggestions from code review
jacobdadams Jul 8, 2021
7677768
fix: no longer just a database
jacobdadams Jul 8, 2021
2c9d9f4
feat: tracks first step
jacobdadams Jul 8, 2021
57389fc
feat: examples page
jacobdadams Jul 8, 2021
4b68e13
try: sgid open data hub
jacobdadams Jul 8, 2021
b1d8dd8
feat: three tracks
jacobdadams Jul 8, 2021
4d21291
fix: descriptions and links
jacobdadams Jul 8, 2021
ab1109e
fix: quick links
jacobdadams Jul 8, 2021
a1af19f
fix: page no longer relevant
jacobdadams Jul 8, 2021
0ec2dfb
fix: all the bad links
jacobdadams Jul 8, 2021
55efc9b
fix: minor edits and links
jacobdadams Jul 8, 2021
9bd3cdd
fix: more links and edits
jacobdadams Jul 8, 2021
56b19d1
chore: policy and example edits
jacobdadams Jul 8, 2021
c27f4b9
chore: name changes galore
jacobdadams Jul 8, 2021
dc1fd94
fix: stable schema for OpenSGID datasets
jacobdadams Jul 8, 2021
34c78ca
fix: standardize "SGID Open Date site"
jacobdadams Jul 8, 2021
f6d78fa
chore: minor niggles
jacobdadams Jul 8, 2021
09523b8
Optimised images with calibre/image-actions
github-actions[bot] Jul 8, 2021
56091b9
chore: hosted data language
jacobdadams Jul 27, 2021
7e74cd1
fix: duplicate policy entry (rebase artifact?)
jacobdadams Jul 27, 2021
dcf0886
Apply suggestions from code review
jacobdadams Aug 17, 2021
c27efb2
chore: remove sharing tab
jacobdadams Aug 18, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 4 additions & 8 deletions _layouts/default.html
Original file line number Diff line number Diff line change
Expand Up @@ -143,14 +143,10 @@ <h2 class="logo-text">UGRC
{%- assign current = page.url | downcase | split: '/' -%}
<nav class="site-nav">
<ul id="menu-main-menu" class="menu">
<li class="menu-item{%- if current[1] == 'news' -%}{{ " active-1" | prepend: " " }}{%- endif -%}"><a
href="{% link news/index.html %}">News</a></li>
<li class="menu-item{%- if current[1] == 'data' -%}{{ " active-2" | prepend: " " }}{%- endif -%}"><a
href="{% link data/index.html %}">Data</a></li>
<li class="menu-item{%- if current[1] == 'developer' -%}{{ " active-3" | prepend: " " }}{%- endif -%}"><a
href="{% link developer/index.md %}">Developer</a></li>
<li class="menu-item{%- if current[1] == 'about' -%}{{ " active-4" | prepend: " " }}{%- endif -%}"><a
href="{% link about/index.md %}">About</a></li>
<li class="menu-item{%- if current[1] == 'news' -%}{{ "active-1" | prepend: " " }}{%- endif -%}"><a href="{% link news/index.html %}">News</a></li>
<li class="menu-item{%- if current[1] == 'data' -%}{{ "active-2" | prepend: " " }}{%- endif -%}"><a href="{% link data/index.html %}">Data</a></li>
<li class="menu-item{%- if current[1] == 'developer' -%}{{ "active-3" | prepend: " " }}{%- endif -%}"><a href="{% link developer/index.md %}">Developer</a></li>
<li class="menu-item{%- if current[1] == 'about' -%}{{ "active-4" | prepend: " " }}{%- endif -%}"><a href="{% link about/index.md %}">About</a></li>
<li class="menu-item"><a href="https://agrc-status.netlify.app/">Status</a></li>
<li class="menu-item"><a href="{% link search/index.html %}">{% include fa_icon.html class="svg-inline--fa
fa-w-16" search=true %}</a></li>
Expand Down
2 changes: 1 addition & 1 deletion _posts/2019-11-12-sgid-product-relaunch-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ UGRC is currently exploring the possibility of expanding the public database to
## Open Data Sharing
{: .text-left}

One of our main goals for the SGID moving forward is to continue to cultivate a sense of open data sharing in the Utah GIS community. The SGID Open Data website is a great example of the success of our [data sharing workflow]({% link gis-data-sharing/open-data/index.md %}), as you can see from the [authoritative data](https://opendata.gis.utah.gov/search?source=utah%20dnr%20online%20maps%2Cutah%20division%20of%20water%20resources) being shared from our agency partners (DNR Water Resources, DNR Water Rights, and Utah Division of State History). We invite our readers to join these partners and participate in this data-sharing initiative. {% include contact.html subject=page.title text="Please get in touch with " contact=site.data.contacts.sgid %} if you have authoritative ArcGIS Online data to share to the SGID Open Data website.
One of our main goals for the SGID moving forward is to continue to cultivate a sense of open data sharing in the Utah GIS community. The SGID Open Data website is a great example of the success of our [data sharing workflow]({% link sharing/index.md %}), as you can see from the [authoritative data](https://opendata.gis.utah.gov/search?source=utah%20dnr%20online%20maps%2Cutah%20division%20of%20water%20resources) being shared from our agency partners (DNR Water Resources, DNR Water Rights, and Utah Division of State History). We invite our readers to join these partners and participate in this data-sharing initiative. {% include contact.html subject=page.title text="Please get in touch with " contact=site.data.contacts.sgid %} if you have authoritative ArcGIS Online data to share to the SGID Open Data website.

We are excited for the future of the SGID, and we hope you will get involved to help us provide the highest quality GIS data to the State of Utah.

Expand Down
4 changes: 2 additions & 2 deletions _posts/2020-07-14-thinking-beyond-the-map.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,8 +94,8 @@ While traditionally we think of GIS as a tool for making maps and creating and m

#### Links related to UGRC's efforts

- [Partnerships and Sharing]({% link gis-data-sharing/index.md %})
- [Data sharing Initiatives - Farm to AGOL project]({% link gis-data-sharing/open-data/index.md %})
- [Partnerships and Sharing]({% link sharing/index.md %})
- [Data sharing Initiatives - Farm to AGOL project]({% link sharing/index.md %}#open-data)
- [State Geographic Information Database (SGID) - data index]({% link data/index.html %})
- [Open Data - SGID ESRI Hub site](https://opendata.gis.utah.gov/)
- [Open SGID - PostgreSQL/PostGIS cloud SGID database]({% link _posts/2020-05-04-introducing-open-sgid.md %})
Expand Down
2 changes: 1 addition & 1 deletion _redirects
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@
/data/farming/grazing-improvement-area/ /data/farming/grazing-improvements/ 301
/data/farming/grazing-improvement-area/ /data/farming/grazing-improvements/ 301
/data/geoscience/aquifers-2/ /data/geoscience/aquifers/ 301
/data/gis-data-sharing/ /gis-data-sharing/ 301
/data/gis-data-sharing/ /sharing/ 301
/data/google-imagery-license-signup/ /discover/license/ 301
/data/google-imagery-license/ /discover/license/ 301
/data/googleimagery/ /data/discover-server-information/ 301
Expand Down
2 changes: 1 addition & 1 deletion about/policy/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Agreement between UGRC and data stewards for data shared through the SGID.
#### [SGID Database Policies]({% link about/policy/sgid/index.md %})
{: .text-left}

UGRC’s guidelines for creating, editing, maintaining, and removing data in the SGID database.
UGRC’s guidelines for creating, editing, maintaining, and removing data in the SGID.

#### [Open SGID Terms of Use]({% link about/policy/open-sgid/index.md %})
{: .text-left}
Expand Down
86 changes: 17 additions & 69 deletions about/policy/metadata/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,109 +6,57 @@ tags:
- metadata
- sgid
date: 2020-07-09 09:33:34 -0600
title: Basic Metadata Guidelines
title: Basic Metadata Requirements
categories: []
---

By most accounts, creating metadata is right up there with organizing your garage. It can be a chore, but it doesn't have to be.

At UGRC, we have decided to make the process more conversational. In other words, instead of looking at a long list of metadata requirements, we thought it would be easier to talk about the data. This is our solution to metadata procrastination.

We have distilled the basic elements of metadata into a few approachable questions. If you can answer these simple questions about your data, then you're officially on your way to good metadata.

#### Can you answer these questions about your data?
{: .text-left}

##### Summarize your Data
{: .text-left}

- What is this dataset?
- What is the purpose of this dataset?

##### Describe your Data
{: .text-left}

- What does this dataset represent?
- ex: road centerlines represent the centerline of a physical road
- How was this dataset created?
- ex: digitized, GPS, etc.
- How reliable and accurate is the dataset?
- ex: survey-grade, mapping-grade, etc.
- What is the general update schedule for this dataset?
- ex: monthly, yearly, as needed, etc.
- Are there any warnings or limitations on the data?
- ex: don’t use parcels as a legal boundary depiction
- ex: don’t use parcels as a complete dataset for geocoding
- ex: don’t use zip codes for demographic generalization
- Are there any common misconceptions or assumptions about this data that should be further explained?
- ex: highway milepost markers are not an accurate length measurement. If a highway is lengthened or shortened, the markers are not adjusted.

##### Establish Contact Info
{: .text-left}

- Who created this dataset?
- What is the best point of contact for this dataset?
- if someone had further questions or would like to get involved, who should they contact?

Your answers to these questions can be plugged into the basic metadata elements (discussed below). It's that simple - answer a few questions, transfer your responses, and voilà, you officially have informative, standardized metadata.

_Note: If you contribute data to Utah's State Geographic Information Database (SGID), we encourage you to use our [metadata form](https://docs.google.com/forms/d/e/1FAIpQLSeJSV935GTN3djtErkBdeXkumuZvd10z2805It1-eFn0Mlo9w/viewform?usp=sf_link). It's a great way to update your metadata and make it more discoverable. The form covers all the questions above -and best of all- after you submit your responses, your portion of the process is done! UGRC, in collaboration with the DTS editor, will handle the remaining details._

The above questions are designed to work with the ESRI [Item Description](https://desktop.arcgis.com/en/arcmap/latest/manage-data/metadata/metadata-standards-and-styles.htm#ESRI_SECTION1_29222DC149544E89A4147541A4ACAF86) metadata style. We have found this style to be well-balanced for creating useful, as well as achievable, metadata.

Let's take a closer look at the basic elements of SGID metadata. We like to think of these as our minimum requirements.

### Basic SGID Metadata
{: .text-left}
Effective metadata helps people understand the source of a dataset, how up-to-date it is, and any of its inherent restrictions or limitations. Listed below are the minimum metadata items that should be present in any SGID datasets. These correspond to the Esri [Item Description](https://pro.arcgis.com/en/pro-app/latest/help/metadata/view-and-edit-metadata.htm) metadata style and the metadata displayed on an item's ArcGIS Online page.
## Basic SGID Metadata

#### Title
{: .text-left}

The title should match the dataset name. If it's a statewide dataset, the title should begin with the word "Utah".

`example: Utah County Boundaries`
Example: `Utah County Boundaries`

#### Tags
{: .text-left}

Tags are included in data searches, so at minimum, each SGID dataset should include the stewarding agency (ie: UGRC), SGID, and the appropriate ISO category tag. We also recommend adding any additional, relevant tags that might help with data discoverability. However, there is no need to include words that are contained in the layer's title (these will be omitted).
Tags are used by ArcGIS Online in its search algorithms and can be used in Open Data to group data. At a minimum, each SGID dataset's tags should include the stewarding agency (ie: UGRC), "SGID", and the appropriate category name. We also recommend adding any additional, relevant tags that might help with data discoverability. However, there is no need to include words that are contained in the layer's title (these will be omitted).
jacobdadams marked this conversation as resolved.
Show resolved Hide resolved

All words in tags should be title-cased except for articles (“of”, “the”, “and”, etc.) or abbreviations. Each tag should be separated by a comma. Please refer to [Using tags effectively](https://www.esri.com/arcgis-blog/products/arcgis-online/data-management/using-tags-effectively/) for more ideas and information.

`example: UGRC, SGID, Recreation, Paths, Biking, Hiking, Horseback Riding`
Example: `UGRC, SGID, Recreation, Paths, Biking, Hiking, Horseback Riding`

#### Summary
{: .text-left}

The summary should summarize the description in approximately 2 to 3 sentences.
The summary should _briefly_ explain the dataset in under 250 characters (an ArcGIS Online limitation). It is primarily used when reviewing ArcGIS Online search results. The summary may end up being very similar to the dataset name for some datasets.

The summary should address the questions presented above in the [summarize your data](#summarize-your-data) section.
Example: `Utah public library and bookmobile locations`
jacobdadams marked this conversation as resolved.
Show resolved Hide resolved

#### Description
{: .text-left}

The Description is a more in-depth version of the summary and it should stand on its own. The description should expand on the summary. This is important, particularly, in the event that the summary is missing in the metadata (which is currently the case with [Open Data](https://opendata.gis.utah.gov/) datasets).

The first line of the description should be a date, indicating the last update.
The description is a more in-depth version of the summary and should stand on its own. It is a great place for details on the source of the data, how frequently it's updated, its usability at certain scales, or any common misconceptions. A good description is also important because it's the main info displayed in [Open Data](https://opendata.gis.utah.gov/) (the summary is not shown).

This section should also contain a link to the corresponding [gis.utah.gov data page]({% link data/index.html %})
The first line of the description should be the date the dataset was last updated so people have a clear and consistent place to see how fresh or stale it is.

Additionally, the description should address the questions presented above in the [describe your data](#describe-your-data) section.
For datasets hosted by UGRC, this section should also contain a link to the corresponding [gis.utah.gov data page]({% link data/index.html %}).

#### Credits (as in the source of the data)
{: .text-left}

This should cover who created the dataset and how you can get in contact with them.
The credits should clearly state who created the dataset and how you can get in contact with them.

The credits should address the questions presented above in the [establish contact info](#establish-contact-info) section.
Example: `UGRC, UDOT`
jacobdadams marked this conversation as resolved.
Show resolved Hide resolved

#### Use Limitations
#### Use Limitations/Terms of Use
{: .text-left}

This section covers limitation and licensing on the data.
This section includes both usage limitations (any constraints on where or how the dataset can be used, including disclaimers and attribution rules) and the intellectual property license (if any) associated with the dataset (like Creative Commons).

The language presented here is for reference only and is populated automatically via our [Sweeper](https://github.com/agrc/sweeper) project.
We use [Sweeper](https://github.com/agrc/sweeper) to automatically populate our hosted datasets with our standard [disclaimer]({% link about/policy/license-disclaimer/index.md %}#disclaimer) and [license]({% link about/policy/license-disclaimer/index.md %}#license).

>The data herein, including but not limited to geographic data, tabular data, analytical data, electronic data structures or files, are provided "as is" without warranty of any kind, either expressed or implied, or statutory, including, but not limited to, the implied warranties or merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the data is assumed by the user.
>[![Creative Commons License](https://i.creativecommons.org/l/by/4.0/88x31.png)](http://creativecommons.org/licenses/by/4.0/){: loading="lazy" }
This work is licensed under a [Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/).
Open Data will try to find references to the common licenses and will link to the appropriate license. Otherwise, it just lists "Custom License" and displays the item's Terms of Use text.
Loading