Update documentation after stat var migration #174

shifucun · 2021-07-09T16:15:53Z

No description provided.

beets

thanks for all these fixes!

could you update your editor settings to only update lint / whitespace in files with modifications?

please also note in the PR description that some obsolete pages are deleted

beets · 2021-07-12T19:08:56Z

api/python/place_in.md

@@ -1,7 +1,7 @@
 ---
 layout: default
-title: Places within a Place
-nav_order: 10
+title: Places Within a Place


please revert the capitalization of "within" for consistency (anne was careful to follow the google documentation style guide)

beets · 2021-07-12T19:09:38Z

api/python/place_in.md

-title: Places within a Place
-nav_order: 10
+title: Places Within a Place
+nav_order: 6


any reason to update the nav ordering?

There are some duplicate nav_order entries which gave random order in final pages. Also the order should be updated as many pages have been removed

beets · 2021-07-12T19:11:45Z

api/python/query.md

Suggested change

These examples and errors, along with explanations and fixes for the errors, are available in this [notebook](https://colab.research.google.com/drive/1Jd0IDHnMdtxhsmXhL5Ib5tL0zgJud1k5?usp=sharing).

These examples and errors, along with explanations and fixes for the errors, are available in this [Python notebook](https://colab.research.google.com/drive/1Jd0IDHnMdtxhsmXhL5Ib5tL0zgJud1k5?usp=sharing).

beets · 2021-07-12T19:11:55Z

api/rest/place_in.md

@@ -1,7 +1,7 @@
 ---
 layout: default
-title: Places within a Place
-nav_order: 9
+title: Places Within a Place


please revert

beets · 2021-07-12T19:12:18Z

api/sheets/places_in.md

@@ -1,7 +1,7 @@
 ---
 layout: default
-title: Places within a Place
-nav_order: 5
+title: Places Within a Place


please revert

beets · 2021-07-12T19:13:34Z

data_model.md

-1. The data model for the base layer is the one used by [Schema.org](https://schema.org). This models the world as a set of entities, with attributes and relationships between entities. There is a taxonomy of entities and each entity is an instance of at least one of the types in the taxonomy. The types and relations types are also entities. This kind of structure has its origins in knowledge representation systems such as KRL and Cyc, and has recently found adoption under the name 'knowledge graph'. The [Node and SPARQL APIs](/api) provide access to this view. The [Data Commons Graph Browser](https://datacommons.org/browser) allows one to browse through Data Commons in this raw graph view
-1. Time series view provides a set of time series for combinations of entities and variables ([Statistical Varables](https://datacommons.org/browser/StatisticalVariable), in Data Commons parlance). The [DCGet API](/api/sheets/get_variable.html) provides API access to this view of the data and the [Data Commons Timelines Tool](https://datacommons.org/tools/timelines) allows one to browse Data Commons in this view.
+1. The data model for the base layer is the one used by [Schema.org](https://schema.org). This models the world as a set of entities, with attributes and relationships between entities. There is a taxonomy of entities and each entity is an instance of at least one of the types in the taxonomy. The types and relations types are also entities. This kind of structure has its origins in knowledge representation systems such as KRL and Cyc, and has recently found adoption under the name "knowledge graph". The [Node and SPARQL APIs](/api) provide access to this view. The [Data Commons Graph Browser](https://datacommons.org/browser) allows one to browse through Data Commons in this raw graph view
+1. Time series view provides a set of time series for combinations of entities and variables ([Statistical Varable](https://datacommons.org/browser/StatisticalVariable), in Data Commons parlance). The [DCGET API](/api/sheets/get_variable.html) provides API access to this view of the data and the [Data Commons Timeline Tool](https://datacommons.org/tools/timeline) allows one to browse Data Commons in this view.


Suggested change

1. Time series view provides a set of time series for combinations of entities and variables ([Statistical Varable](https://datacommons.org/browser/StatisticalVariable), in Data Commons parlance). The [DCGET API](/api/sheets/get_variable.html) provides API access to this view of the data and the [Data Commons Timeline Tool](https://datacommons.org/tools/timeline) allows one to browse Data Commons in this view.

1. Time series view provides a set of time series for combinations of entities and variables ([Statistical Variable](https://datacommons.org/browser/StatisticalVariable), in Data Commons parlance). The [DCGET API](/api/sheets/get_variable.html) provides API access to this view of the data and the [Data Commons Timeline Tool](https://datacommons.org/tools/timeline) allows one to browse Data Commons in this view.

beets · 2021-07-12T19:14:35Z

glossary.md


-A complete list of properties can be found at <https://datacommons.org/browser/scalingFactor>.


please keep this line, even if redundant. the headings don't look very clickable at the moment.

Added this back to be consistent with other items

beets · 2021-07-12T19:15:08Z

glossary.md

Suggested change

The unit of measurement. Examples include [kilowatt hours](https://datacommons.org/browser/KilowattHour), [inches](https://datacommons.org/browser/Inch), and [Indian Rupees](https://datacommons.org/browser/IndianRupee). A complete list of properties can be found in the [browser](https://datacommons.org/browser/unit).

The unit of measurement. Examples include [kilowatt hours](https://datacommons.org/browser/KilowattHour), [inches](https://datacommons.org/browser/Inch), and [Indian Rupees](https://datacommons.org/browser/IndianRupee). A complete list of properties can be found in the [graph browser](https://datacommons.org/browser/unit).

beets · 2021-07-12T19:16:07Z

glossary.md

@@ -10,51 +10,49 @@ This page contains a selection of key terms important to understanding the struc

 ## Term List

- **[Cohort](http://browser.datacommons.org/kg?dcid=CohortSet)**
+### **[Cohort](https://datacommons.org/browser/CohortSet)**


the bold might not be necessary if it is now also a heading.

should we make the links clearer by making it separate from the heading? e.g.

Cohort (graph node)

or

Cohort

(see the browser node)

Good idea. Updated

beets

thanks for the updates!

shifucun · 2021-07-12T21:58:56Z

Thanks for review!

Fix documentation mentioning StatisticalPopulation

5b957d3

shifucun requested review from beets and pradh July 9, 2021 17:00

Bo Xu added 2 commits July 9, 2021 10:00

more

0a62017

more format

479d0ac

shifucun changed the title ~~Fix documentation mentioning StatisticalPopulation~~ Update documentation after stat var migration Jul 9, 2021

fix tutorials

6333a5b

beets reviewed Jul 12, 2021

View reviewed changes

resolve comments

f533bad

shifucun requested a review from beets July 12, 2021 21:10

beets approved these changes Jul 12, 2021

View reviewed changes

shifucun merged commit e2a2031 into datacommonsorg:master Jul 12, 2021

enjoythecode mentioned this pull request Feb 17, 2022

docs.datacommons.org/tutorials.html 404 #166

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update documentation after stat var migration #174

Update documentation after stat var migration #174

shifucun commented Jul 9, 2021

beets left a comment

beets Jul 12, 2021

shifucun Jul 12, 2021

beets Jul 12, 2021

shifucun Jul 12, 2021

beets Jul 12, 2021

beets Jul 12, 2021

shifucun Jul 12, 2021

beets Jul 12, 2021

shifucun Jul 12, 2021

beets Jul 12, 2021

shifucun Jul 12, 2021

beets Jul 12, 2021

shifucun Jul 12, 2021

beets Jul 12, 2021

shifucun Jul 12, 2021

beets Jul 12, 2021

beets Jul 12, 2021

beets Jul 12, 2021

shifucun Jul 12, 2021

beets left a comment

shifucun commented Jul 12, 2021

	These examples and errors, along with explanations and fixes for the errors, are available in this [notebook](https://colab.research.google.com/drive/1Jd0IDHnMdtxhsmXhL5Ib5tL0zgJud1k5?usp=sharing).
	These examples and errors, along with explanations and fixes for the errors, are available in this [Python notebook](https://colab.research.google.com/drive/1Jd0IDHnMdtxhsmXhL5Ib5tL0zgJud1k5?usp=sharing).


		A complete list of properties can be found at <https://datacommons.org/browser/scalingFactor>.

	The unit of measurement. Examples include [kilowatt hours](https://datacommons.org/browser/KilowattHour), [inches](https://datacommons.org/browser/Inch), and [Indian Rupees](https://datacommons.org/browser/IndianRupee). A complete list of properties can be found in the [browser](https://datacommons.org/browser/unit).
	The unit of measurement. Examples include [kilowatt hours](https://datacommons.org/browser/KilowattHour), [inches](https://datacommons.org/browser/Inch), and [Indian Rupees](https://datacommons.org/browser/IndianRupee). A complete list of properties can be found in the [graph browser](https://datacommons.org/browser/unit).

Update documentation after stat var migration #174

Update documentation after stat var migration #174

Conversation

shifucun commented Jul 9, 2021

beets left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Cohort (graph node)

Cohort

Choose a reason for hiding this comment

beets left a comment

Choose a reason for hiding this comment

shifucun commented Jul 12, 2021