Merge pull request #584 from cmu-delphi/main

Sync documentation hotfixes

Author: krivard

docs/Gemfile.lock

@@ -204,14 +204,14 @@ GEM
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.3.6)
-    mini_portile2 (2.5.0)
+    mini_portile2 (2.5.1)
     minima (2.5.1)
       jekyll (>= 3.5, < 5.0)
       jekyll-feed (~> 0.9)
       jekyll-seo-tag (~> 2.1)
     minitest (5.14.4)
     multipart-post (2.1.1)
-    nokogiri (1.11.2)
+    nokogiri (1.11.5)
       mini_portile2 (~> 2.5.0)
       racc (~> 1.4)
     octokit (4.20.0)

docs/api/covidcast-signals/fb-survey.md

@@ -0,0 +1,47 @@
+---
+title: Survey Modules & Randomization
+parent: COVID Symptom Survey
+nav_order: 7
+---
+
+# Questions and Coding
+{: .no_toc}
+
+To reduce the overall length of the instrument and minimize response burden, the
+COVID Symptom Survey will consist of a block of daily core questions and will
+use a randomized module approach for the other topics. Implementation of this
+approach started in [Wave 11](coding.md#wave-11), which launched on May 20,
+2021.
+
+Each respondent invited to take the survey will be asked the daily core
+questions. The daily core questions for Wave 11 include:
+
+* Symptoms
+* Testing
+* COVID-19 vaccine
+* Behaviors
+
+After answering these questions, survey respondents will be randomly allocated
+and evenly distributed to Module A or Module B.
+
+Survey items in Module A cover the following topics:
+
+* Beliefs and Norms
+* Knowledge and Information
+* Healthcare
+
+Survey items in Module B cover the following topics:
+
+* Well-being
+* Parenting behaviors (including schooling)
+* Specific demographic questions (i.e. cigarette use and pregnancy)
+
+After the modules, the survey will conclude with asking respondents demographics
+and occupation questions. It is also noteworthy that after randomization to
+either Module A or B, the platform does not allow respondents to navigate back
+to change their previous responses in the Daily Core questions.
+
+Microdata files available to users with data use agreements include a `module`
+column that indicates the module the respondent was randomly assigned to; this
+column contains the values `A`, `B`, or `NA` (for respondents not assigned to a
+module, e.g. because they completed a prior survey wave).

docs/symptom-survey/coding.md

@@ -1,7 +1,7 @@
 ---
 title: Problems and Data Errors
 parent: COVID Symptom Survey
-nav_order: 7
+nav_order: 8
 ---
 
 # Problems and Data Errors
@@ -17,6 +17,29 @@ results. All problems will be logged here.
 1. TOC
 {:toc}
 
+## Mistranslation of Distances (May 2021)
+
+In Wave 11, all items were re-translated to ensure consistency of the
+translations. The new item H1, on social distancing, is:
+
+> When out in public in the past 7 days, how many people maintained a distance
+> of at least 6 feet from others?
+
+In French, it was translated to read as follows:
+
+> Lorsque vous êtes sorti(e) au cours des 7 derniers jours, combien de personnes
+> ont maintenu une distance d’au moins 6 mètres entre elles ?
+
+This incorrectly translated 6 feet to 6 meters. On June 7, 2021 at 9:50am
+Pacific time, we corrected the text to read:
+
+> Lorsque vous êtes sorti(e) au cours des 7 derniers jours, combien de personnes
+> ont maintenu une distance d’au moins 2 mètres entre elles ?
+
+This problem only affected the French translation. The `UserLanguage` column in
+the survey data files indicates the translation used by each respondent to
+complete the survey.
+
 ## Election-Related Sample Size Decreases (Nov 2020)
 
 Sample sizes decreased in the days following the 2020 US presidential election.

docs/symptom-survey/contingency-tables.md

@@ -62,7 +62,7 @@ single data frame for use.
 Several days after the end of each month, we produce "rollup" files containing
 all survey responses from that month. These are in two forms.
 
-First, the monthly CSV files have filenames in the form
+First, the monthly CSV files have filenames of the form
 
     {YYYY}-{mm}.csv.gz