From 139f6905b313a06d3464c68ffac27a416580dfa9 Mon Sep 17 00:00:00 2001
From: Carolyn Au <cyin@google.com>
Date: Tue, 18 Jan 2022 16:47:41 -0800
Subject: [PATCH 1/2] move sheets tutorials to api/sheets/tutorials

---
 Gemfile.lock                                  | 141 ++++++++++--------
 _layouts/default.html                         |  18 ++-
 api/sheets/index.md                           |   5 +-
 api/sheets/tutorials/index.md                 |  16 ++
 .../sheets/tutorials}/sheets_covid.md         |  21 +--
 .../sheets/tutorials}/sheets_latitude.md      |  17 ++-
 .../sheets/tutorials}/sheets_sleep.md         |  17 ++-
 .../tutorials/sheets_covid_tutorial_1.png     | Bin
 .../tutorials/sheets_covid_tutorial_2.png     | Bin
 .../tutorials/sheets_covid_tutorial_3.png     | Bin
 .../tutorials/sheets_covid_tutorial_4.png     | Bin
 .../tutorials/sheets_covid_tutorial_5.png     | Bin
 .../tutorials/sheets_covid_tutorial_6.png     | Bin
 .../tutorials/sheets_covid_tutorial_7.png     | Bin
 .../tutorials/sheets_covid_tutorial_8.png     | Bin
 .../tutorials/sheets_covid_tutorial_9.png     | Bin
 .../tutorials/sheets_latitude_tutorial_1.png  | Bin
 .../tutorials/sheets_latitude_tutorial_2.png  | Bin
 .../tutorials/sheets_latitude_tutorial_3.png  | Bin
 .../tutorials/sheets_latitude_tutorial_4.png  | Bin
 .../tutorials/sheets_latitude_tutorial_5.png  | Bin
 .../tutorials/sheets_latitude_tutorial_6.png  | Bin
 .../tutorials/sheets_latitude_tutorial_7.png  | Bin
 .../tutorials/sheets_sleep_tutorial_1.png     | Bin
 .../tutorials/sheets_sleep_tutorial_2.png     | Bin
 .../tutorials/sheets_sleep_tutorial_3.png     | Bin
 .../tutorials/sheets_sleep_tutorial_4.png     | Bin
 .../tutorials/sheets_sleep_tutorial_5.png     | Bin
 .../tutorials/sheets_sleep_tutorial_6.png     | Bin
 .../tutorials/sheets_sleep_tutorial_7.png     | Bin
 statistical_variables.md                      |   2 +-
 tutorials/index.md                            |  17 +--
 32 files changed, 147 insertions(+), 107 deletions(-)
 create mode 100644 api/sheets/tutorials/index.md
 rename {tutorials => api/sheets/tutorials}/sheets_covid.md (83%)
 rename {tutorials => api/sheets/tutorials}/sheets_latitude.md (83%)
 rename {tutorials => api/sheets/tutorials}/sheets_sleep.md (84%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_1.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_2.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_3.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_4.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_5.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_6.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_7.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_8.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_covid_tutorial_9.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_latitude_tutorial_1.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_latitude_tutorial_2.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_latitude_tutorial_3.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_latitude_tutorial_4.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_latitude_tutorial_5.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_latitude_tutorial_6.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_latitude_tutorial_7.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_sleep_tutorial_1.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_sleep_tutorial_2.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_sleep_tutorial_3.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_sleep_tutorial_4.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_sleep_tutorial_5.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_sleep_tutorial_6.png (100%)
 rename assets/images/{ => sheets}/tutorials/sheets_sleep_tutorial_7.png (100%)

diff --git a/Gemfile.lock b/Gemfile.lock
index 53d68114a..1d79f206a 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,7 +1,7 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.4)
+    activesupport (6.0.4.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
@@ -17,37 +17,43 @@ GEM
     commonmarker (0.17.13)
       ruby-enum (~> 0.5)
     concurrent-ruby (1.1.9)
-    dnsruby (1.61.7)
+    dnsruby (1.61.9)
       simpleidn (~> 0.1)
-    em-websocket (0.5.2)
+    em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
-      http_parser.rb (~> 0.6.0)
-    ethon (0.14.0)
+      http_parser.rb (~> 0)
+    ethon (0.15.0)
       ffi (>= 1.15.0)
     eventmachine (1.2.7)
     execjs (2.8.1)
-    faraday (1.5.0)
+    faraday (1.9.3)
       faraday-em_http (~> 1.0)
       faraday-em_synchrony (~> 1.0)
       faraday-excon (~> 1.1)
-      faraday-httpclient (~> 1.0.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
       faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.1)
+      faraday-net_http_persistent (~> 1.0)
       faraday-patron (~> 1.0)
-      multipart-post (>= 1.2, < 3)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
       ruby2_keywords (>= 0.0.4)
     faraday-em_http (1.0.0)
     faraday-em_synchrony (1.0.0)
     faraday-excon (1.1.0)
     faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.3)
+      multipart-post (>= 1.2, < 3)
     faraday-net_http (1.0.1)
-    faraday-net_http_persistent (1.1.0)
+    faraday-net_http_persistent (1.2.0)
     faraday-patron (1.0.0)
-    ffi (1.15.3)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
+    ffi (1.15.5)
     forwardable-extended (2.6.0)
     gemoji (3.0.1)
-    github-pages (215)
-      github-pages-health-check (= 1.17.2)
+    github-pages (223)
+      github-pages-health-check (= 1.17.9)
       jekyll (= 3.9.0)
       jekyll-avatar (= 0.7.0)
       jekyll-coffeescript (= 1.1.1)
@@ -56,6 +62,7 @@ GEM
       jekyll-feed (= 0.15.1)
       jekyll-gist (= 1.5.0)
       jekyll-github-metadata (= 2.13.0)
+      jekyll-include-cache (= 0.2.1)
       jekyll-mentions (= 1.6.0)
       jekyll-optional-front-matter (= 0.3.2)
       jekyll-paginate (= 1.1.0)
@@ -67,19 +74,19 @@ GEM
       jekyll-seo-tag (= 2.7.1)
       jekyll-sitemap (= 1.4.0)
       jekyll-swiss (= 1.0.0)
-      jekyll-theme-architect (= 0.1.1)
-      jekyll-theme-cayman (= 0.1.1)
-      jekyll-theme-dinky (= 0.1.1)
-      jekyll-theme-hacker (= 0.1.2)
-      jekyll-theme-leap-day (= 0.1.1)
-      jekyll-theme-merlot (= 0.1.1)
-      jekyll-theme-midnight (= 0.1.1)
-      jekyll-theme-minimal (= 0.1.1)
-      jekyll-theme-modernist (= 0.1.1)
-      jekyll-theme-primer (= 0.5.4)
-      jekyll-theme-slate (= 0.1.1)
-      jekyll-theme-tactile (= 0.1.1)
-      jekyll-theme-time-machine (= 0.1.1)
+      jekyll-theme-architect (= 0.2.0)
+      jekyll-theme-cayman (= 0.2.0)
+      jekyll-theme-dinky (= 0.2.0)
+      jekyll-theme-hacker (= 0.2.0)
+      jekyll-theme-leap-day (= 0.2.0)
+      jekyll-theme-merlot (= 0.2.0)
+      jekyll-theme-midnight (= 0.2.0)
+      jekyll-theme-minimal (= 0.2.0)
+      jekyll-theme-modernist (= 0.2.0)
+      jekyll-theme-primer (= 0.6.0)
+      jekyll-theme-slate (= 0.2.0)
+      jekyll-theme-tactile (= 0.2.0)
+      jekyll-theme-time-machine (= 0.2.0)
       jekyll-titles-from-headings (= 0.5.3)
       jemoji (= 0.12.0)
       kramdown (= 2.3.1)
@@ -87,19 +94,19 @@ GEM
       liquid (= 4.0.3)
       mercenary (~> 0.3)
       minima (= 2.5.1)
-      nokogiri (>= 1.10.4, < 2.0)
+      nokogiri (>= 1.12.5, < 2.0)
       rouge (= 3.26.0)
       terminal-table (~> 1.4)
-    github-pages-health-check (1.17.2)
+    github-pages-health-check (1.17.9)
       addressable (~> 2.3)
       dnsruby (~> 1.60)
       octokit (~> 4.0)
-      public_suffix (>= 2.0.2, < 5.0)
+      public_suffix (>= 3.0, < 5.0)
       typhoeus (~> 1.3)
     html-pipeline (2.14.0)
       activesupport (>= 2)
       nokogiri (>= 1.4)
-    http_parser.rb (0.6.0)
+    http_parser.rb (0.8.0)
     i18n (0.9.5)
       concurrent-ruby (~> 1.0)
     jekyll (3.9.0)
@@ -136,6 +143,8 @@ GEM
     jekyll-github-metadata (2.13.0)
       jekyll (>= 3.4, < 5.0)
       octokit (~> 4.0, != 4.4.0)
+    jekyll-include-cache (0.2.1)
+      jekyll (>= 3.7, < 5.0)
     jekyll-mentions (1.6.0)
       html-pipeline (~> 2.3)
       jekyll (>= 3.7, < 5.0)
@@ -162,45 +171,45 @@ GEM
     jekyll-swiss (1.0.0)
     jekyll-tabs (1.1.0)
       jekyll (>= 3.0, < 5.0)
-    jekyll-theme-architect (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-architect (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-cayman (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-cayman (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-dinky (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-dinky (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-hacker (0.1.2)
+    jekyll-theme-hacker (0.2.0)
       jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-leap-day (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-leap-day (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-merlot (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-merlot (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-midnight (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-midnight (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-minimal (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-minimal (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-modernist (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-modernist (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-primer (0.5.4)
+    jekyll-theme-primer (0.6.0)
       jekyll (> 3.5, < 5.0)
       jekyll-github-metadata (~> 2.9)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-slate (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-slate (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-tactile (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-tactile (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
-    jekyll-theme-time-machine (0.1.1)
-      jekyll (~> 3.5)
+    jekyll-theme-time-machine (0.2.0)
+      jekyll (> 3.5, < 5.0)
       jekyll-seo-tag (~> 2.0)
     jekyll-titles-from-headings (0.5.3)
       jekyll (>= 3.3, < 5.0)
@@ -215,27 +224,27 @@ GEM
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
     liquid (4.0.3)
-    listen (3.5.1)
+    listen (3.7.1)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.3.6)
-    mini_portile2 (2.6.1)
+    mini_portile2 (2.7.1)
     minima (2.5.1)
       jekyll (>= 3.5, < 5.0)
       jekyll-feed (~> 0.9)
       jekyll-seo-tag (~> 2.1)
-    minitest (5.14.4)
+    minitest (5.15.0)
     multipart-post (2.1.1)
-    nokogiri (1.12.5)
-      mini_portile2 (~> 2.6.1)
+    nokogiri (1.13.1)
+      mini_portile2 (~> 2.7.0)
       racc (~> 1.4)
-    octokit (4.21.0)
+    octokit (4.22.0)
       faraday (>= 0.9)
       sawyer (~> 0.8.0, >= 0.5.3)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     public_suffix (4.0.6)
-    racc (1.5.2)
+    racc (1.6.0)
     rb-fsevent (0.11.0)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
@@ -243,7 +252,7 @@ GEM
     rouge (3.26.0)
     ruby-enum (0.9.0)
       i18n
-    ruby2_keywords (0.0.4)
+    ruby2_keywords (0.0.5)
     rubyzip (2.3.2)
     safe_yaml (1.0.5)
     sass (3.7.4)
@@ -265,9 +274,9 @@ GEM
       thread_safe (~> 0.1)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.7.7)
-    unicode-display_width (1.7.0)
-    zeitwerk (2.4.2)
+    unf_ext (0.0.8)
+    unicode-display_width (1.8.0)
+    zeitwerk (2.5.3)
 
 PLATFORMS
   ruby
@@ -279,4 +288,4 @@ DEPENDENCIES
   jekyll-tabs
 
 BUNDLED WITH
-   2.2.15
+   1.17.2
diff --git a/_layouts/default.html b/_layouts/default.html
index 10b7423b0..7df20e2e7 100644
--- a/_layouts/default.html
+++ b/_layouts/default.html
@@ -96,10 +96,22 @@
                 <nav aria-label="Breadcrumb" id="main-breadcrumb">
                   <ol class="breadcrumb">
                     {% if page.grand_parent %}
-                      <li class="breadcrumb-item"><a href="{{ first_level_url }}">{{ page.grand_parent }}</a></li>
-                      <li class="breadcrumb-item"><a href="{{ second_level_url }}">{{ page.parent }}</a></li>
+                      <li class="breadcrumb-item">
+                        <a href="{%- if page.grand_parent_url -%}{{ page.grand_parent_url }}{% else %}{{ first_level_url }}{% endif -%}">
+                          {{ page.grand_parent }}
+                        </a>
+                      </li>
+                      <li class="breadcrumb-item">
+                        <a href="{%- if page.parent_url -%}{{ page.parent_url }}{% else %}{{ second_level_url }}{% endif -%}">
+                          {{ page.parent }}
+                        </a>
+                      </li>
                     {% else %}
-                      <li class="breadcrumb-item"><a href="{{ first_level_url }}">{{ page.parent }}</a></li>
+                      <li class="breadcrumb-item">
+                        <a href="{%- if page.parent_url -%}{{ page.parent_url }}{% else %}{{ first_level_url }}{% endif -%}">
+                          {{ page.parent }}
+                        </a>
+                      </li>
                     {% endif %}
                     <li class="breadcrumb-item active"><span>{{ page.title }}</span></li>
                   </ol>
diff --git a/api/sheets/index.md b/api/sheets/index.md
index af6cd5d63..6746a4595 100644
--- a/api/sheets/index.md
+++ b/api/sheets/index.md
@@ -12,6 +12,7 @@ users to import data from the Data Commons knowledge graph. The add-on provides
 interface for finding a location's [DCID](/glossary.html), as well as some custom functions for
 importing data to a spreadsheet.
 
+Also read our [step-by-step guides](tutorials/) for more examples.
 ## Getting started
 
 Install the add-on from [G Suite Marketplace](https://gsuite.google.com/marketplace/app/data_commons/454343067575). To enable the add-on in a document, click "Add-ons > Data Commons > Fill place dcids". You may use the resulting sidebar to start [finding dcids](/api/sheets/get_dcid.html) in the United States, or close it and reopen it at any time. Note that none of the custom functions will work in a given document until you have enabled the add-on by choosing "Fill place dcids".
@@ -38,10 +39,12 @@ Note that this feature only supports places in the United States.
 
 <p>Please check the following video for a complete example:</p>
 
+<div>
 <video width="960" height="520" controls>
   <source src="/assets/video/sort.webm" type="video/webm">
 Your browser does not support the video tag.
 </video>
+</div>
 
 <p>To summarize, the steps are:</p>
 
@@ -49,4 +52,4 @@ Your browser does not support the video tag.
 <li>Populate data columns with DataCommons Sheets API</li>
 <li>Turn on filter views (Data > Filter views).</li>
 <li>Click the reverse triangle on each column to sort by that column (and exclude header row).</li>
-</ul>
+</ul>
\ No newline at end of file
diff --git a/api/sheets/tutorials/index.md b/api/sheets/tutorials/index.md
new file mode 100644
index 000000000..904338f3d
--- /dev/null
+++ b/api/sheets/tutorials/index.md
@@ -0,0 +1,16 @@
+---
+layout: default
+title: Tutorials
+nav_order: 100
+parent: Google Sheets
+grand_parent: API
+has_children: true
+---
+
+# Tutorials
+
+Get familiar with the [Data Commons Google Sheets API](..) with these step-by-step guides:
+
+-   [Analyze the COVID-19 pandemic](sheets_covid.html)
+-   [Obtain latitude information for country capitals in South America](sheets_latitude.html)
+-   [Sorting the CDC 500 cohort on sleep](sheets_sleep.html)
\ No newline at end of file
diff --git a/tutorials/sheets_covid.md b/api/sheets/tutorials/sheets_covid.md
similarity index 83%
rename from tutorials/sheets_covid.md
rename to api/sheets/tutorials/sheets_covid.md
index e03eda1eb..e9a91efd2 100644
--- a/tutorials/sheets_covid.md
+++ b/api/sheets/tutorials/sheets_covid.md
@@ -3,6 +3,9 @@ layout: default
 title: Sheets COVID-19 Analysis
 nav_order: 3
 parent: Tutorials
+parent_url: /api/sheets/tutorials
+grand_parent: Google Sheets
+grand_parent_url: /api/sheets
 ---
 
 # Using Data Commons' Google Sheets API to analyze the COVID-19 pandemic
@@ -13,44 +16,44 @@ Throughout the ongoing COVID-19 pandemic, the Data Commons team has been working
 ## Step 1: Setup
 Pull up Google Sheets and create a new, blank spreadsheet. You can title it `Data Commons COVID-19 analysis` or any other name of your choosing.
 
-![](/assets/images/tutorials/sheets_covid_tutorial_1.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_1.png)
 
 To enable the Data Commons API in your spreadsheet, ensure that the Data Commons extension is installed and available under the Extensions tab in the main menu. Hover over the Data Commons menu item, then click on the Fill Place DCIDs option.
 
-![](/assets/images/tutorials/sheets_covid_tutorial_2.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_2.png)
 
 A menu should pop up on the right side of the Sheets web application. Type the name of any place desired; its DCID should populate into the A1 entry of the chart. This step is required to enable the Data Commons API.
 
-![](/assets/images/tutorials/sheets_covid_tutorial_3.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_3.png)
 
 Next, double-click on A1 in the chart and type `country/USA`.
 
-![](/assets/images/tutorials/sheets_covid_tutorial_4.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_4.png)
 
 ## Step 2: Retrieving place names and DCIDs from Data Commons
 To obtain the DCIDs for all the states, you can use the plugin function `DCPLACESIN`. Type `=DCPLACESIN(A1, "State")` into cell B1. Sheets will provide pointers to help guide your function inputs. Your spreadsheet output should look like this:
 
-![](/assets/images/tutorials/sheets_covid_tutorial_5.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_5.png)
 
 Finally, you’ll want to retrieve the state names and position them conveniently near these DCIDs. You can use the plugin function `DCGETNAME` to access this information. Type `=DCGETNAME(B1)` in cell C1, then click and drag to repeat this formula throughout the C column. Your final output should look like this:
 
-![](/assets/images/tutorials/sheets_covid_tutorial_6.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_6.png)
 
 ## Step 3: Populating the spreadsheet with COVID information
 In this tutorial, you will be analyzing each state’s cumulative count of deaths due to COVID as of December 15, 2020. To do this, you will need to get the value of the [statistical variable](/glossary.html) `CumulativeCount_MedicalConditionIncident_COVID_19_PatientDeceased` for each state on the date specified. You can use the `DCGET` method to do this.
 
 Type `=DCGET(B1, "CumulativeCount_MedicalConditionIncident_COVID_19_PatientDeceased", "2020-12-15")` into cell D1, then click and drag to repeat this formula throughout the D column. Your final output should look like this:
 
-![](/assets/images/tutorials/sheets_covid_tutorial_7.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_7.png)
 
 ## Step 4: Visualizing the data
 As a final step, you can use Google’s Geo Chart option to map this data! Select cell arrays C1:C52 and D1:D52, then click on the Chart option under Insert in the main menu. Your spreadsheet will look a bit like this:
 
-![](/assets/images/tutorials/sheets_covid_tutorial_8.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_8.png)
 
 Feel free to drag the histogram out of the way of the numbers! As a final step, under `Chart type` in the right sidebar, click on the map. Under the chart customization options, you can click on the `Geo` dropdown, then select the United States region to display your results. Your final sheet should look something like this:
 
-![](/assets/images/tutorials/sheets_covid_tutorial_9.png)
+![](/assets/images/sheets/tutorials/sheets_covid_tutorial_9.png)
 
 If you’d like to experiment more with the data and methods from this tutorial, check out <https://docs.google.com/spreadsheets/d/1yK4YCpwF2AeiaVIfINXVHXw5O3BEjPyWnCSsqonfVBM/edit?usp=sharing>. You can copy the spreadsheet at <https://docs.google.com/spreadsheets/d/1yK4YCpwF2AeiaVIfINXVHXw5O3BEjPyWnCSsqonfVBM/copy>. Note that you will need to enable the Sheets API as in Step 1 to retrieve the data for analysis.
 
diff --git a/tutorials/sheets_latitude.md b/api/sheets/tutorials/sheets_latitude.md
similarity index 83%
rename from tutorials/sheets_latitude.md
rename to api/sheets/tutorials/sheets_latitude.md
index fc695c355..f9fda04a2 100644
--- a/tutorials/sheets_latitude.md
+++ b/api/sheets/tutorials/sheets_latitude.md
@@ -3,6 +3,9 @@ layout: default
 title: Sheets South American Latitudes
 nav_order: 4
 parent: Tutorials
+parent_url: /api/sheets/tutorials
+grand_parent: Google Sheets
+grand_parent_url: /api/sheets
 ---
 
 # Obtaining latitude information for country capitals in South America
@@ -13,34 +16,34 @@ The Data Commons API enables end users to obtain basic information about the ent
 ## Step 1: Setup
 Pull up Google Sheets and create a new, blank spreadsheet. You can title it `Data Commons South American capitals’ latitude` or any other name of your choosing.
 
-![](/assets/images/tutorials/sheets_latitude_tutorial_1.png)
+![](/assets/images/sheets/tutorials/sheets_latitude_tutorial_1.png)
 
 To enable the Data Commons API in your spreadsheet, ensure that the Data Commons extension is installed and available under the Extensions tab in the main menu. Hover over the Data Commons menu item, then click on the Fill Place DCIDs option.
 
- ![](/assets/images/tutorials/sheets_latitude_tutorial_2.png)
+ ![](/assets/images/sheets/tutorials/sheets_latitude_tutorial_2.png)
 
 ## Step 2: Retrieving place names and DCIDs from Data Commons
 Double-click on A1 in the chart and enter [`southamerica`](https://datacommons.org/browser/southamerica) (the DCID for the continent of South America).
 
-![](/assets/images/tutorials/sheets_latitude_tutorial_3.png)
+![](/assets/images/sheets/tutorials/sheets_latitude_tutorial_3.png)
 
 To obtain the DCIDs for all the countries, you can use the plugin function [`DCPLACESIN`](/api/sheets/places_in.html). Type `=DCPLACESIN(A1, "Country")` into cell B1. Sheets will provide pointers to help guide your function inputs. Your spreadsheet output should look like this:
 
-![](/assets/images/tutorials/sheets_latitude_tutorial_4.png)
+![](/assets/images/sheets/tutorials/sheets_latitude_tutorial_4.png)
 
 Next, you’ll want to retrieve the country names and position them conveniently near these DCIDs. You can use the plugin function [`DCGETNAME`](/api/sheets/get_name.html) to access this information. Type `=dcgetname(B1:B)` in cell C1. Your final output will look like this:
 
-![](/assets/images/tutorials/sheets_latitude_tutorial_5.png)
+![](/assets/images/sheets/tutorials/sheets_latitude_tutorial_5.png)
 
 ## Step 3: Populating the spreadsheet with capital and latitude information
 In this step, you will obtain all South American countries’ capitals and latitudes. To do this, you will need to get the value of the property names [`latitude`](https://datacommons.org/browser/latitude) and [`administrativeCapital`](https://datacommons.org/browser/administrativeCapital) for each country on the date specified. (As an aside, if you'd like to see what properties are available for any given entity, Data Commons provides a [graph browser](https://datacommons.org/browser) tool enabling you to look up any entity in the graph and view its associated properties.) You can use the [`DCPROPERTY`](/api/sheets/get_property.html) method to do this.
 
 Type `=DCPROPERTY(B1:B, "administrativeCapital")` into cell D1. Your output should look like this:
 
-![](/assets/images/tutorials/sheets_latitude_tutorial_6.png)
+![](/assets/images/sheets/tutorials/sheets_latitude_tutorial_6.png)
 
 Now, to get the latitude of each capital, type `=DCPROPERTY(D1:D, "latitude")` into cell E1.
 
-![](/assets/images/tutorials/sheets_latitude_tutorial_7.png)
+![](/assets/images/sheets/tutorials/sheets_latitude_tutorial_7.png)
 
 If you’d like to experiment more with the data and methods from this tutorial, check out <https://docs.google.com/spreadsheets/d/1AYOD9yX59aKNNHoLLsmy00uihU72EKDFDZVo5KdX7H0/edit#gid=0>. You can clone the sheet by clicking on the File dropdown, then choosing the 'Make a copy' option. Note that you will need to enable the Sheets API as in Step 1 to retrieve the data for analysis.
diff --git a/tutorials/sheets_sleep.md b/api/sheets/tutorials/sheets_sleep.md
similarity index 84%
rename from tutorials/sheets_sleep.md
rename to api/sheets/tutorials/sheets_sleep.md
index 1a06c9ee6..9ee02186d 100644
--- a/tutorials/sheets_sleep.md
+++ b/api/sheets/tutorials/sheets_sleep.md
@@ -3,6 +3,9 @@ layout: default
 title: Sheets CDC 500 Sleep Sorting
 nav_order: 2
 parent: Tutorials
+parent_url: /api/sheets/tutorials
+grand_parent: Google Sheets
+grand_parent_url: /api/sheets
 ---
 
 # Sorting the CDC 500 cohort on sleep 
@@ -14,29 +17,29 @@ The Data Commons API enables easy access to health data for the 500 cities the C
 ## Step 1: Setup
 Pull up Google Sheets and create a new, blank spreadsheet. You can title it `Data Commons CDC 500 sleep analysis` or any other name of your choosing.
 
-![](/assets/images/tutorials/sheets_sleep_tutorial_1.png)
+![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_1.png)
 
 To enable the Data Commons API in your spreadsheet, ensure that the Data Commons extension is installed and available under the Extensions tab in the main menu. Hover over the Data Commons menu item, then click on the Fill Place DCIDs option.
 
-![](/assets/images/tutorials/sheets_sleep_tutorial_2.png)
+![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_2.png)
 
 ## Step 2: Get the DCIDs and names of cohort members
 Data Commons provides the method [`DCCOHORTMEMBERS`](https://docs.datacommons.org/api/sheets/get_cohort_members.html) for obtaining the members of a Data Commons cohort. Here, you’ll use this method to retrieve the cities in the CDC 500 cohort. Start by double-clicking on A1 in the chart and enter `CDC500_City`.
 
-![](/assets/images/tutorials/sheets_sleep_tutorial_3.png)
+![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_3.png)
 
 In cell B1, enter `=DCCOHORTMEMBERS(A1)`. The output should look like this:
 
-![](/assets/images/tutorials/sheets_sleep_tutorial_4.png)
+![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_4.png)
 
 To get the names of these cities, enter `=DCGETNAME(B1:B500)` into cell C1. The output should look like this:
 
-![](/assets/images/tutorials/sheets_sleep_tutorial_5.png)
+![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_5.png)
 
 ## Step 3: Obtain the sleep health level for each city.
 We will use the percentage of chronically restless residents in each city using the `DCGET` method with the statistical variable `Percent_Person_SleepLessThan7Hours`. (More information on statistical variables is available in the [glossary](https://docs.datacommons.org/glossary.html).) Enter `=DCGET(B1:B500, "Percent_Person_SleepLessThan7Hours", "2016")` into cell D1 in your spreadsheet. The output should look like this:
 
-![](/assets/images/tutorials/sheets_sleep_tutorial_6.png)
+![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png)
 
 ## Step 4: Sort on sleep score.
 Data Commons has made a tutorial on sorting in Sheets available at <https://docs.datacommons.org/api/sheets/>. To summarize, the process of sorting on columns looks like this:
@@ -47,7 +50,7 @@ Data Commons has made a tutorial on sorting in Sheets available at <https://docs
 
 Follow the example in the video to sort your spreadsheet on the F column. Your final output should look like this:
 
-![](/assets/images/tutorials/sheets_sleep_tutorial_7.png)
+![](/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png)
 
 Note the added headers and resized column widths for increased clarity. Also, if you’re experiencing slow sorting in the sheet, consider replacing the method calls in the C and D columns with their values. To do this, copy the columns, then paste by value only into their original locations in the spreadsheet.
 
diff --git a/assets/images/tutorials/sheets_covid_tutorial_1.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_1.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_1.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_1.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_2.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_2.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_2.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_2.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_3.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_3.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_3.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_3.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_4.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_4.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_4.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_4.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_5.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_5.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_5.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_5.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_6.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_6.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_6.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_6.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_7.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_7.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_7.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_7.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_8.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_8.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_8.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_8.png
diff --git a/assets/images/tutorials/sheets_covid_tutorial_9.png b/assets/images/sheets/tutorials/sheets_covid_tutorial_9.png
similarity index 100%
rename from assets/images/tutorials/sheets_covid_tutorial_9.png
rename to assets/images/sheets/tutorials/sheets_covid_tutorial_9.png
diff --git a/assets/images/tutorials/sheets_latitude_tutorial_1.png b/assets/images/sheets/tutorials/sheets_latitude_tutorial_1.png
similarity index 100%
rename from assets/images/tutorials/sheets_latitude_tutorial_1.png
rename to assets/images/sheets/tutorials/sheets_latitude_tutorial_1.png
diff --git a/assets/images/tutorials/sheets_latitude_tutorial_2.png b/assets/images/sheets/tutorials/sheets_latitude_tutorial_2.png
similarity index 100%
rename from assets/images/tutorials/sheets_latitude_tutorial_2.png
rename to assets/images/sheets/tutorials/sheets_latitude_tutorial_2.png
diff --git a/assets/images/tutorials/sheets_latitude_tutorial_3.png b/assets/images/sheets/tutorials/sheets_latitude_tutorial_3.png
similarity index 100%
rename from assets/images/tutorials/sheets_latitude_tutorial_3.png
rename to assets/images/sheets/tutorials/sheets_latitude_tutorial_3.png
diff --git a/assets/images/tutorials/sheets_latitude_tutorial_4.png b/assets/images/sheets/tutorials/sheets_latitude_tutorial_4.png
similarity index 100%
rename from assets/images/tutorials/sheets_latitude_tutorial_4.png
rename to assets/images/sheets/tutorials/sheets_latitude_tutorial_4.png
diff --git a/assets/images/tutorials/sheets_latitude_tutorial_5.png b/assets/images/sheets/tutorials/sheets_latitude_tutorial_5.png
similarity index 100%
rename from assets/images/tutorials/sheets_latitude_tutorial_5.png
rename to assets/images/sheets/tutorials/sheets_latitude_tutorial_5.png
diff --git a/assets/images/tutorials/sheets_latitude_tutorial_6.png b/assets/images/sheets/tutorials/sheets_latitude_tutorial_6.png
similarity index 100%
rename from assets/images/tutorials/sheets_latitude_tutorial_6.png
rename to assets/images/sheets/tutorials/sheets_latitude_tutorial_6.png
diff --git a/assets/images/tutorials/sheets_latitude_tutorial_7.png b/assets/images/sheets/tutorials/sheets_latitude_tutorial_7.png
similarity index 100%
rename from assets/images/tutorials/sheets_latitude_tutorial_7.png
rename to assets/images/sheets/tutorials/sheets_latitude_tutorial_7.png
diff --git a/assets/images/tutorials/sheets_sleep_tutorial_1.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_1.png
similarity index 100%
rename from assets/images/tutorials/sheets_sleep_tutorial_1.png
rename to assets/images/sheets/tutorials/sheets_sleep_tutorial_1.png
diff --git a/assets/images/tutorials/sheets_sleep_tutorial_2.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_2.png
similarity index 100%
rename from assets/images/tutorials/sheets_sleep_tutorial_2.png
rename to assets/images/sheets/tutorials/sheets_sleep_tutorial_2.png
diff --git a/assets/images/tutorials/sheets_sleep_tutorial_3.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_3.png
similarity index 100%
rename from assets/images/tutorials/sheets_sleep_tutorial_3.png
rename to assets/images/sheets/tutorials/sheets_sleep_tutorial_3.png
diff --git a/assets/images/tutorials/sheets_sleep_tutorial_4.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_4.png
similarity index 100%
rename from assets/images/tutorials/sheets_sleep_tutorial_4.png
rename to assets/images/sheets/tutorials/sheets_sleep_tutorial_4.png
diff --git a/assets/images/tutorials/sheets_sleep_tutorial_5.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_5.png
similarity index 100%
rename from assets/images/tutorials/sheets_sleep_tutorial_5.png
rename to assets/images/sheets/tutorials/sheets_sleep_tutorial_5.png
diff --git a/assets/images/tutorials/sheets_sleep_tutorial_6.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png
similarity index 100%
rename from assets/images/tutorials/sheets_sleep_tutorial_6.png
rename to assets/images/sheets/tutorials/sheets_sleep_tutorial_6.png
diff --git a/assets/images/tutorials/sheets_sleep_tutorial_7.png b/assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png
similarity index 100%
rename from assets/images/tutorials/sheets_sleep_tutorial_7.png
rename to assets/images/sheets/tutorials/sheets_sleep_tutorial_7.png
diff --git a/statistical_variables.md b/statistical_variables.md
index 1fbd0c112..b35deb7cb 100644
--- a/statistical_variables.md
+++ b/statistical_variables.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Statistical Variables
-nav_order: 4
+nav_order: 7
 ---
 
 # Statistical Variables
diff --git a/tutorials/index.md b/tutorials/index.md
index 8f305d3f5..b50f0928e 100644
--- a/tutorials/index.md
+++ b/tutorials/index.md
@@ -1,11 +1,11 @@
 ---
 layout: default
-title: Tutorials
+title: Case studies
 nav_order: 5
-has_children: true
+has_children: false
 ---
 
-# Tutorials
+# Case studies
 
 Get familiar with the Data Commons Graph and API's using these analysis examples.
 You can also clone these to use as a base for your own analysis.
@@ -38,13 +38,4 @@ Python:
 
 -   **Case Study: Drug Discovery with Biomedical Data Commons**
 
-    [Google Colab](https://colab.research.google.com/drive/1dSKYiRMn3mbDsInorQzYM0yk7sqv6fIV){:target="_blank"}, [Github](https://github.com/datacommonsorg/api-python/blob/master/notebooks/Drug_Discovery_With_Data_Commons.ipynb){:target="_blank"}
-
-
-## Google Sheets
-
-Step-by-step guides to using the Google Sheets API:
-
--   [Analyze the COVID-19 pandemic](/tutorials/sheets_covid.html)
--   [Obtain latitude information for country capitals in South America](/tutorials/sheets_latitude.html)
--   [Sorting the CDC 500 cohort on sleep](/tutorials/sheets_sleep.html)
\ No newline at end of file
+    [Google Colab](https://colab.research.google.com/drive/1dSKYiRMn3mbDsInorQzYM0yk7sqv6fIV){:target="_blank"}, [Github](https://github.com/datacommonsorg/api-python/blob/master/notebooks/Drug_Discovery_With_Data_Commons.ipynb){:target="_blank"}
\ No newline at end of file

From cac6d9a072c363c2879decd44a2d02a11e505911 Mon Sep 17 00:00:00 2001
From: Carolyn Au <cyin@google.com>
Date: Tue, 18 Jan 2022 16:49:09 -0800
Subject: [PATCH 2/2] fix spacing

---
 api/sheets/index.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/api/sheets/index.md b/api/sheets/index.md
index 6746a4595..a3f45c9f5 100644
--- a/api/sheets/index.md
+++ b/api/sheets/index.md
@@ -13,6 +13,7 @@ interface for finding a location's [DCID](/glossary.html), as well as some custo
 importing data to a spreadsheet.
 
 Also read our [step-by-step guides](tutorials/) for more examples.
+
 ## Getting started
 
 Install the add-on from [G Suite Marketplace](https://gsuite.google.com/marketplace/app/data_commons/454343067575). To enable the add-on in a document, click "Add-ons > Data Commons > Fill place dcids". You may use the resulting sidebar to start [finding dcids](/api/sheets/get_dcid.html) in the United States, or close it and reopen it at any time. Note that none of the custom functions will work in a given document until you have enabled the add-on by choosing "Fill place dcids".