diff --git a/README.md b/README.md index b008af453..3bd7ca554 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ The documentation site is built using Jekyll. To run this locally: 1. Install [Ruby](https://jekyllrb.com/docs/installation/) 1. Run `bundle update` -1. Run `bundle exec jekyll serve` +1. Run `bundle exec jekyll serve --incremental` If you make changes to yml files, re-run `bundle exec jekyll serve` diff --git a/api/sheets/index.md b/api/sheets/index.md index d101a8dfb..3e1a1db89 100644 --- a/api/sheets/index.md +++ b/api/sheets/index.md @@ -10,7 +10,8 @@ has_children: true The **Data Commons Sheets API** is a Google Sheets add-on that enables Google Sheets users to import data from the Data Commons knowledge graph. The add-on provides an interface for finding a location’s unique Data Commons identifier ([DCID](glossary.html#dcid)), and some custom functions for importing data into a spreadsheet. -> **Note:** For more information on DCIDs, refer to [Unique Identifiers (dcid)](/bigquery/unique_identifiers.html). +> **Note:** +> For more information on DCIDs, refer to the entry for [DCID in the Glossary](/glossary.html#dcid). Also read our [step-by-step guides](tutorials/) for more examples. @@ -66,15 +67,15 @@ Your browser does not support the video tag. The preceding video performs the following steps in a blank Sheets document: -1. Returns a list of DCIDs in column A that represent counties in California, using the formula **={"Place";DCPLACESIN(geoId/06", "County"}. -2. Uses the DCIDs in column A to fill in the names of each county in column B using the =DCGETNAME(A2) formula. -3. Retrieves the population of the county in column C using the DCIDs in column A using the =DCGET(A2, "Count_Person") formula. +1. Returns a list of DCIDs in column A that represent counties in California, using the formula ={"Place";DCPLACESIN(geoId/06", "County"}. +2. Uses the DCIDs in column A to fill in the names of each county in column B using the =DCGETNAME(A2) formula. +3. Retrieves the population of the county in column C using the DCIDs in column A using the =DCGET(A2, "Count_Person") formula. 4. Highlights the entire sheet and click Data menu, Filter views, then Create new filter, or click the Create a filter icon on the toolbar. 5. Next, the filter is sorted by the Population column from A-Z and then from Z-A. The same sorts are then performed on the Name column. To summarize, the steps for sorting Data Commons results with Google Sheets filter view feature are: 1. Populate the data columns with Data Commons Sheets API formulas. -2. Turn on filter views by clicking the **Data** menu**,** **Filter views**, then **Create new filter view**, or by clicking the **Create a filter** icon on the toolbar -3. Click the reverse triangle on each column to sort, excluding the header row. +2. Turn on filter views by clicking the **Data** menu, **Filter views**, then **Create new filter view**, or by clicking the **Create a filter** icon on the toolbar +3. Click the reverse triangle on each column to sort, excluding the header row. diff --git a/bigquery/unique_identifiers.md b/bigquery/unique_identifiers.md index 0364459b9..1e26b1fac 100644 --- a/bigquery/unique_identifiers.md +++ b/bigquery/unique_identifiers.md @@ -5,10 +5,10 @@ nav_order: 2 parent: BigQuery --- -# Unique Identifiers (dcid) +# Unique Identifiers (DCID) -Every entity in Data Commons (DC) has a unique identifier, called ‘dcid’. So, for example, the dcid of California is ['geoId/06'](https://datacommons.org/place/geoId/06) and of India is ['country/IND'](https://datacommons.org/place/country/IND). dcids are not restricted to entities; statistical variables also have dcid, for example the dcid for the Gini Index of Economic Activity is ['GiniIndex_EconomicActivity'](https://datacommons.org/tools/statvar#GiniIndex_EconomicActivity). +Every entity in Data Commons (DC) has a unique identifier, called ‘DCID’. So, for example, the DCID of California is ['geoId/06'](https://datacommons.org/place/geoId/06) and of India is ['country/IND'](https://datacommons.org/place/country/IND). DCIDs are not restricted to entities; statistical variables also have DCID, for example the DCID for the Gini Index of Economic Activity is ['GiniIndex_EconomicActivity'](https://datacommons.org/tools/statvar#GiniIndex_EconomicActivity). -Answers to questions like ‘what are all the cities in California?’ is a set of dcid for the cities. To facilitate joining DC entities with non-DC data, Data Commons stores the various unique IDs (e.g., FIPS, Wikidata ID, Google Maps place ID, etc) used to reference places in different sources. See the sample queries about [Joining DC with your own data](/bigquery/query_join_your_data.html) for some examples. +Answers to questions like ‘what are all the cities in California?’ is a set of DCIDs for the cities. To facilitate joining DC entities with non-DC data, Data Commons stores the various unique IDs (e.g., FIPS, Wikidata ID, Google Maps place ID, etc) used to reference places in different sources. See the sample queries about [Joining DC with your own data](/bigquery/query_join_your_data.html) for some examples. -You can find the dcid for a place by searching for it in the [Place Explorer tool](https://datacommons.org/place). +You can find the DCID for a place by searching for it in the [Place Explorer tool](https://datacommons.org/place), and the DCID for statistical variables in the [Statistical Variable Explorer tool](https://datacommons.org/tools/statvar). diff --git a/glossary.md b/glossary.md index 1ceea46cd..2a3ed8e23 100644 --- a/glossary.md +++ b/glossary.md @@ -34,7 +34,9 @@ The date of measurement. Specified in ISO 8601 format. Examples include `2011` ( ### DCID {: #dcid} -Short for 'Data Commons Identifier', a DCID is a distinct identifier for a node in the knowledge graph. These can represent variables or entities. For example, Austin, Texas, has a DCID of `geoId/4805000`, while the plant species _Austrobaileya scandens_ has a DCID of `dc/bsmvthtq89217`. +Every entity in the Data Commons graph has a unique identifier, called ‘DCID’ (short for Data Commons Identifier). So, for example, the DCID of California is [`geoId/06`](https://datacommons.org/browser/geoId/06) and of India is [`country/IND`](https://datacommons.org/browser/country/IND). DCIDs are not restricted to entities; every node in the graph has a DCID. Statistical variables have DCID, for example the DCID for the Gini Index of Economic Activity is [`GiniIndex_EconomicActivity`](https://datacommons.org/tools/statvar#GiniIndex_EconomicActivity). + +You can find the DCID for a place by searching for it in the [Place Explorer tool](https://datacommons.org/place), and the DCID for statistical variables in the [Statistical Variable Explorer tool](https://datacommons.org/tools/statvar). All nodes have an entry in the [Graph Browser](https://datacommons.org/browser/). ### Entity {: #entity}