Merge pull request #290 from cmu-delphi/docs/terms-of-use

krivard · web-flow · commit 5d3ef1063748 · 2020-11-18T18:29:58.000-05:00
Updates to data licensing &amp; terms
diff --git a/docs/api/README.md b/docs/api/README.md
@@ -37,17 +37,15 @@ like to cite it, we would gratefully recommend the following copy:
 
 ## Data licensing
 
-The majority of the data surfaced through this API is more or less just a
-carefully curated mirror of data acquired from various external parties. Such
-data is subject to its original licensing, where applicable.
-
----
+Several datasets surfaced through this API are carefully curated mirrors of data
+acquired from various external parties. Such data is subject to its original
+licensing, where applicable.
 
 Any data which is produced novelly by Delphi and is intentionally and openly
 surfaced by Delphi through this API is hereby licensed
-[CC-BY](https://creativecommons.org/licenses/by/4.0/). Endpoints, as specified
-by the `source` parameter, which are known to wholly or partially serve data
-under this license include:
+[CC BY](https://creativecommons.org/licenses/by/4.0/) except where otherwise
+noted. Endpoints, as specified by the `source` parameter, which are known to
+wholly or partially serve data under this license include:
 
 - `covidcast`
 - `covidcast_meta`
diff --git a/docs/api/covidcast-signals/_source-template.md b/docs/api/covidcast-signals/_source-template.md
@@ -12,6 +12,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 0
 * **Date of last change:** Never
 * **Available for:** county, hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** LINK
 
 A brief description of what this source measures.
 
diff --git a/docs/api/covidcast-signals/doctor-visits.md b/docs/api/covidcast-signals/doctor-visits.md
@@ -11,6 +11,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 1
 * **Date of last change:** 9 November 2020
 * **Available for:** county, hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](../covidcast_licensing.md#creative-commons-attribution)
 
 This data source is based on information about outpatient visits, provided to us
 by health system partners. Using this outpatient data, we estimate the
diff --git a/docs/api/covidcast-signals/fb-survey.md b/docs/api/covidcast-signals/fb-survey.md
@@ -11,6 +11,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 1
 * **Date of last change:** [3 June 2020](../covidcast_changelog.md#fb-survey)
 * **Available for:** county, hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](../covidcast_licensing.md#creative-commons-attribution)
 
 This data source is based on symptom surveys run by the Delphi group at Carnegie
 Mellon. Facebook directs a random sample of its users to these surveys, which
diff --git a/docs/api/covidcast-signals/google-survey.md b/docs/api/covidcast-signals/google-survey.md
@@ -11,6 +11,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 0
 * **Date of last change:** Never
 * **Available for:** county, hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](../covidcast_licensing.md#creative-commons-attribution)
 
 Data source based on Google-run symptom surveys, through publisher websites,
 their Opinions Reward app, and similar applications. Respondents can opt to skip
diff --git a/docs/api/covidcast-signals/hospital-admissions.md b/docs/api/covidcast-signals/hospital-admissions.md
@@ -12,6 +12,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 1
 * **Date of last change:** 20 October 2020
 * **Available for:** county, hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](../covidcast_licensing.md#creative-commons-attribution)
 
 This data source is based on electronic medical records and claims data about
 hospital admissions, provided to us by health system partners. We use this
diff --git a/docs/api/covidcast-signals/indicator-combination.md b/docs/api/covidcast-signals/indicator-combination.md
@@ -24,6 +24,7 @@ calculated or composed by Delphi. It is not a primary data source.
 * **Number of data revisions since 19 May 2020:** 1
 * **Date of last change:** [3 June 2020](../covidcast_changelog.md#indicator-combination)
 * **Available for:** county, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](../covidcast_licensing.md#creative-commons-attribution)
 
 These signals combine Delphi's indicators---*not* including cases and deaths,
 but including other signals expected to be related to the underlying rate of
diff --git a/docs/api/covidcast-signals/jhu-csse.md b/docs/api/covidcast-signals/jhu-csse.md
@@ -11,6 +11,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 1
 * **Date of last change:** [7 October 2020](../covidcast_changelog.md#jhu-csse)
 * **Available for:** county, hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](#source-and-licensing)
 
 This data source of confirmed COVID-19 cases and deaths is based on reports made
 available by the Center for Systems Science and Engineering at Johns Hopkins
@@ -118,3 +119,10 @@ properly.
 |-------------------|---------------|-------------------|---------------|
 |Oglala Lakota      |South Dakota   |46113              |46102          |
 |Kusilvak           |Alaska         |02270              |02158          |
+
+## Source and Licensing
+
+This data set is republished from the COVID-19 Data Repository by the Center for
+Systems Science and Engineering (CSSE) at Johns Hopkins University, under the
+terms of the [Creative Commons Attribution 4.0 International (CC BY 4.0)
+license](https://creativecommons.org/licenses/by/4.0/).
diff --git a/docs/api/covidcast-signals/quidel.md b/docs/api/covidcast-signals/quidel.md
@@ -21,6 +21,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 1
 * **Date of last change:** 22 October 2020
 * **Available for:** hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](../covidcast_licensing.md#creative-commons-attribution)
 
 Data source based on COVID-19 Antigen tests, provided to us by Quidel, Inc. When
 a patient (whether at a doctor’s office, clinic, or hospital) has COVID-like
diff --git a/docs/api/covidcast-signals/safegraph.md b/docs/api/covidcast-signals/safegraph.md
@@ -11,6 +11,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 23 June 2020:** 1
 * **Date of last change:** 3 November 2020
 * **Available for:** county, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](../covidcast_licensing.md#creative-commons-attribution)
 
 This data source uses data reported by [SafeGraph](https://www.safegraph.com/)
 using anonymized location data from mobile phones. SafeGraph provides [social
diff --git a/docs/api/covidcast-signals/usa-facts.md b/docs/api/covidcast-signals/usa-facts.md
@@ -11,6 +11,7 @@ grand_parent: COVIDcast Epidata API
 * **Number of data revisions since 19 May 2020:** 2
 * **Date of last change:** [3 November 2020](../covidcast_changelog.md#usa-facts)
 * **Available for:** county, hrr, msa, state (see [geography coding docs](../covidcast_geography.md))
+* **License:** [CC BY](#source-and-licensing)
 
 This data source of confirmed COVID-19 cases and deaths is based on reports made
 available by [USAFacts](https://usafacts.org/).
@@ -143,3 +144,9 @@ SECONDARY_FIPS = [   # generated by notebooks/create-mappings.ipynb
 	('51678', ['51163']),
     ]
 ```
+
+## Source and Licensing
+
+This data set is republished from the USAFacts known cases and deaths datasets,
+under the terms of the [Creative Commons Attribution 4.0 International (CC BY
+4.0) license](https://creativecommons.org/licenses/by/4.0/).
diff --git a/docs/api/covidcast.md b/docs/api/covidcast.md
@@ -17,13 +17,6 @@ partners. The API allows users to select specific signals and download data for
 selected geographical areas---counties, states, metropolitan statistical areas,
 and other divisions.
 
-This data is freely available under our [licensing](README.md#data-licensing)
-terms; we encourage academic users to [cite](README.md#citing) the data if they
-use it in any publications. Our [data ingestion
-code](https://github.com/cmu-delphi/covidcast-indicators) and [API server
-code](https://github.com/cmu-delphi/delphi-epidata) is open-source, and
-contributions are welcome. Further documentation on Delphi's APIs is available
-in the [API overview](README.md).
 
 <div style="background-color:#FCC; padding: 10px 30px;"><strong>Get
 updates:</strong> Delphi operates a <a
@@ -41,6 +34,15 @@ href="https://lists.andrew.cmu.edu/mailman/listinfo/delphi-covidcast-api">subscr
 1. TOC
 {:toc}
 
+## Licensing
+Like all other Delphi Epidata datasets, our COVIDcast data is freely available to the public. However, our COVID-19 surveillance streams include data from many different sources, with data licensing handled separately for each source. For a summary of the licenses used and a list of the indicators each license applies to, we suggest users visit our [COVIDcast licensing](covidcast_licensing.md) page. Licensing information is also summarized on each indicator's details page.
+We encourage academic users to [cite](README.md#citing) the data if they
+use it in any publications. Our [data ingestion
+code](https://github.com/cmu-delphi/covidcast-indicators) and [API server
+code](https://github.com/cmu-delphi/delphi-epidata) is open-source, and
+contributions are welcome. Further documentation on Delphi's APIs is available
+in the [API overview](README.md).
+
 ## Accessing the Data
 
 Our [COVIDcast site](https://covidcast.cmu.edu) provides an interactive
diff --git a/docs/api/covidcast_licensing.md b/docs/api/covidcast_licensing.md
@@ -0,0 +1,56 @@
+---
+title: COVIDcast Data Licensing
+parent: COVIDcast Epidata API
+nav_order: 2
+---
+
+# Licensing for Delphi's COVID-19 Data Streams
+
+## Novel Data
+
+These data streams include data produced novelly by Delphi and intentionally and
+openly surfaced by Delphi through this API.
+
+### Creative Commons: Attribution
+
+This data is provided under the terms of the [Creative Commons Attribution
+license](https://creativecommons.org/licenses/by/4.0/). If you use this data,
+you must cite [Delphi's COVIDcast Epidata API](README.md#citing).
+
+COVIDcast signals included:
+
+* `doctor-visits`
+* `hospital-admissions`
+* `indicator-combination`:`nmf_*`
+* `quidel`
+* `fb-survey`
+
+### Creative Commons: Attribution-NonCommercial
+
+This data is provided under the terms of the [Creative Commons
+Attribution-NonCommercial
+license](https://creativecommons.org/licenses/by-nc/4.0/). If you use this data,
+you must cite [Delphi's COVIDcast Epidata API](README.md#citing). You
+may not use this data for commercial purposes.
+
+COVIDcast signals included:
+
+* `chng`
+
+## Republished Data
+
+These data streams are essentially mirrors of their respective sources, and are
+published here subject to the original license provided by the source. More
+information on the license for each source is available on their respective
+pages.
+
+If you use the Delphi's COVIDcast Epidata API to access this data, we
+additionally request you [acknowledge us](README.md#citing) in your product or
+publication.
+
+COVIDcast signals included:
+
+* `ght`
+* `jhu-csse`
+* `safegraph`
+* `usa-facts`
