Merge pull request #171 from revisit-studies/lh/textTweaks

Text / Spelling Updates

public/VLAT/config-VLAT.hjson

@@ -7,7 +7,7 @@
             The reVISit Team
         ]
         date: 2023-06-14
-        description: A replicaiton of the VLAT study, using image stimuli.
+        description: A replication of the VLAT questionnaire, using image stimuli.
         organizations: [
             University of Utah
             WPI
@@ -2655,4 +2655,4 @@
         introduction
         trials
     ]
-}
+}

public/VLAT/introduction.md

@@ -1,6 +1,11 @@
 # Introduction
 
+This is a reVISit adaptation of the original VLAT questionnaire from Kwon et al.
+
+From their study: 
+
 ## What is VLAT?
+
 VLAT is developed to measure users' ability to read, understand, and
 use data visualizations to solve problems. This test is a web
 adaptation of the original test.
@@ -10,4 +15,4 @@ visualizations. It will take approximately 25 minutes to finish this
 test. For each question, you will be given a static data
 visualization (left) and a problem to solve (right). Choose the BEST
 answer to the questions. If you don't know the answer, select
-'skip'. We suggest maximizing your browser window.
+'skip'. We suggest maximizing your browser window."

public/cleveland/config-cleveland.hjson

@@ -1,13 +1,13 @@
 {
     $schema: https://raw.githubusercontent.com/reVISit-studies/study/main/src/parser/schema.json
     studyMetadata: {
-        title: Dyanmic React Stimuli: A Graphical Perception Experiment
+        title: Dynamic React.js Stimuli: A Graphical Perception Experiment
         version: pilot
         authors: [
             The reVISit Team
         ]
         date: 2023-04-28
-        description: A demo using dynamic React components as stiumli to replicate the Cleveland/McGill, and the Heer/Bostock extension of graphical perception studies with post study survey.
+        description: A demo using dynamic React components as stimuli to replicate a Cleveland & McGill graphical perception task, with a post study survey.
         organizations: [
             University of Utah
             WPI
@@ -43,7 +43,7 @@
                 }
                 {
                     id: accept
-                    prompt: Do you accept the consent form?
+                    prompt: Do you consent to the study and wish to continue?
                     required: true
                     location: belowStimulus
                     type: radio
@@ -942,4 +942,4 @@
         trials1
         post-study-survey1
     ]
-}
+}

public/cleveland/consent-cm.md

@@ -28,4 +28,4 @@ experimental procedures at any time they see fit.
 
 By accepting below, you acknowledge that you have been informed about and consent to be a participant in the study 
 described above. Make sure that your questions are answered to your satisfaction before signing. You are entitled to 
-retain a copy of this consent agreement.
+retain a copy of this consent agreement.

public/cleveland/introduction.md

@@ -1,5 +1,5 @@
 # Introduction
 
-Welcome to our study. This is a complex example study to show how to embed react components into the study page. In this example, the react components are responsible for rendering the stimuli, but the revisit framework handles the answer tracking.
+Welcome to our study. This is a more complex example to show how to embed React.js components into the study page. In this example, React components are responsible for rendering the stimuli, but the reVISit framework automatically handles  answer tracking.
 
-This study is a replication of a graphical perception study by Clevland & McGill with the Heer & Bostock extension.
+This study is a replication of a graphical perception study by Clevland & McGill 1984 with the Heer & Bostock 2010 extension.

public/click-accuracy-test/click-accuracy-test.hjson

@@ -7,7 +7,7 @@
             The reVISit Team
         ]
         date: 2023-06-15
-        description: A demo of using React dynamic stimuli, and receive input from it.
+        description: A demo of using React dynamic stimuli, and receiving input from it.
         organizations: [
             University of Utah
             WPI
@@ -65,4 +65,4 @@
         introduction
         trials1
     ]
-}
+}

public/click-accuracy-test/introduction.md

@@ -2,4 +2,4 @@
 
 Welcome to our study, This is a click accuracy test -- to test your accuracy of clicking on a moving dot.
 
-This is an example project to show how to pass answers from React component to Revisit Framework.
+This is an example project to show how to pass answers from React component to reVISit Framework.

public/html-demo/config-html-demo.hjson

@@ -7,7 +7,7 @@
             The reVISit Team
         ]
         date: 2023-04-14
-        description: A simple demo of using a stimuli in an html file that renders a D3 visualization. Data is collected via a numeric response field.
+        description: A simple demo of using stimuli in an HTML file that renders a D3 visualization. Data is collected via a numeric response field.
         organizations: [
             University of Utah
             WPI
@@ -41,7 +41,7 @@
                         difficulty: hard
                     }
                     description: Question that asks users to count the number of bars that have a value greater than 1.
-                    instruction: How many bars have a value great than 1?
+                    instruction: How many bars have a value greater than 1?
                     path: html-demo/bar-chart.html
                     response: [
                         {
@@ -63,4 +63,4 @@
         introduction
         trials1
     ]
-}
+}

public/html-input/config-html-input.hjson

@@ -70,4 +70,4 @@
         introduction
         trials1
     ]
-}
+}

public/html-input/help.md

@@ -1 +1,3 @@
-This is a simple demo of using HTML stimuli, and receiving answers from it. You can click on any bar in bar chart to select answer and click **Next**. Note your selected answer will be displayed below.
+This is a simple demo of using HTML stimuli, and receiving answers from it. 
+You can click on any bar in bar chart to select answer and click **Next**. 
+Note your selected answer will be displayed below.

public/html-input/introduction.md

@@ -1,3 +1,4 @@
 # Introduction
 
-Welcome to our study. This is an example study to show how to embed html elements into the study page. In this example, the html stimulus is able to communicate with the revisit study framework to save the clicked bar as the answer in the study provenance.
+Welcome to our study. This is an example study to show how to embed HTML elements into the study page. 
+In this example, the HTML stimulus communicates with the reVISit study framework to save the clicked bar as the answer, which is also stored in the study provenance.

public/mvnv/config-html-MVNV.hjson

@@ -7,7 +7,7 @@
             The reVISit Team
         ]
         date: 2023-04-26
-        description: "A replication of adjacent matrix tasks in the MVNV study "
+        description: "A replication of adjacency matrix tasks in a multi-variate network visualization (MVNV) study "
         organizations: [
             University of Utah
             WPI
@@ -43,7 +43,7 @@
                 }
                 {
                     id: accept
-                    prompt: Do you accept the consent form?
+                    prompt: Do you consent to the study and wish to continue?
                     required: true
                     location: belowStimulus
                     type: radio
@@ -645,4 +645,4 @@
         trials14
         trials15
     ]
-}
+}

public/mvnv/introduction.md

@@ -1,7 +1,7 @@
 # Introduction
 
-Welcome to our study. This is a complex example study to show how to embed html elements into the study page. In this example, the html stimulus is able to communicate with the revisit study framework to save the clicked answer in the stimulus as the answer in the study provenance.
+Welcome to our study. This is a more complex example to show how to embed HTML elements into the study page. In this example, the HTML stimulus is able to communicate with the reVISit study framework to save the clicked answer in the stimulus as the answer in the study provenance.
 
 This study is a replication of a study by Nobre et al. published in Proceedings of the 2020 CHI Conference on Human Factors in Computing Systems.
 
-We replicate almost the whole study here, including training and trials, but there is no guided training module.
+We replicate nearly the whole study here, including training trials, but there currently is no guided training module.

public/survey-demo/config-survey-demo.hjson

@@ -1,13 +1,13 @@
 {
     $schema: https://raw.githubusercontent.com/reVISit-studies/study/main/src/parser/schema.json
     studyMetadata: {
-        title: A demo for supported survey questions
+        title: Question Types Demo
         version: pilot
         authors: [
             The reVISit Team
         ]
         date: 2023-04-30
-        description: A demo for supported survey questions
+        description: A demo of supported survey question types
         organizations: [
             University of Utah
             WPI
@@ -121,4 +121,4 @@
         introduction
         survey
     ]
-}
+}

tests/cleveland.spec.ts

@@ -4,10 +4,10 @@ test('test', async ({ page }) => {
   await page.goto('/');
 
   // Click on cleveland
-  await page.getByRole('button', { name: 'Dyanmic React Stimuli: A Graphical Perception Experiment A demo using dynamic React components as stiumli to replicate the Cleveland/McGill, and the Heer/Bostock extension of graphical perception studies with post study survey.' }).click();
+  await page.getByRole('button', { name: 'Dynamic React.js Stimuli: A Graphical Perception Experiment A demo using dynamic React components as stimuli to replicate a Cleveland & McGill graphical perception task, with a post study survey.' }).click();
 
   // Check that the page contains the introduction text
-  const introText = await page.getByText('Welcome to our study. This is a complex example study to show how to embed react');
+  const introText = await page.getByText('Welcome to our study. This is a more complex example to show how to embed React.js');
   await expect(introText).toBeVisible();
 
   // Click on the next button

tests/click-accuracy-test.spec.ts

@@ -2,7 +2,7 @@ import { test, expect } from '@playwright/test';
 
 test('test', async ({ page }) => {
   await page.goto('/');
-  await page.getByRole('button', { name: 'Click Accuracy Test A demo of using React dynamic stimuli, and receive input from it.' }).click();
+  await page.getByRole('button', { name: 'Click Accuracy Test A demo of using React dynamic stimuli, and receiving input from it.' }).click();
 
   // Check for introduction page
   const introText = await page.getByRole('heading', { name: 'Introduction' });

tests/html-demo.spec.ts

@@ -4,7 +4,7 @@ test('html demo works as intended', async ({ page }) => {
   await page.goto('/');
 
   // Click on html-demo
-  await page.getByRole('button', { name: 'HTML as a Stimulus A simple demo of using a stimuli in an html file that renders a D3 visualization. Data is collected via a numeric response field.' }).click();
+  await page.getByRole('button', { name: 'HTML as a Stimulus A simple demo of using stimuli in an HTML file that renders a D3 visualization. Data is collected via a numeric response field.' }).click();
 
   // Check that the page contains the introduction text
   const introText = await page.getByText('Welcome to our study. This is an example study to show how to embed html element');
@@ -14,7 +14,7 @@ test('html demo works as intended', async ({ page }) => {
   await page.getByRole('button', { name: 'Next' }).click();
 
   // Check the page contains the question
-  const questionText = await page.getByText('How many bars have a value great than 1?');
+  const questionText = await page.getByText('How many bars have a value greater than 1?');
   await expect(questionText).toBeVisible();
 
   // Check the page contains the visualization

tests/mvnv.spec.ts

@@ -4,10 +4,10 @@ test('test', async ({ page }) => {
   await page.goto('/');
 
   // Click on mvnv study
-  await page.getByRole('button', { name: 'MVNV Study Replication A replication of adjacent matrix tasks in the MVNV study' }).click();
+  await page.getByRole('button', { name: 'MVNV Study Replication A replication of adjacency matrix tasks in a multi-variate network visualization (MVNV) study' }).click();
 
   // Check for introduction page
-  const introText = await page.getByText('Welcome to our study. This is a complex example study to show how to embed html');
+  const introText = await page.getByText('Welcome to our study. This is a more complex example to show how to embed HTML');
   await expect(introText).toBeVisible();
 
   // Click on next button

tests/survey-demo.spec.ts

@@ -2,7 +2,7 @@ import { test, expect } from '@playwright/test';
 
 test('test', async ({ page }) => {
   await page.goto('/');
-  await page.getByRole('button', { name: 'A demo for supported survey questions A demo for supported survey questions' }).click();
+  await page.getByRole('button', { name: 'Question Types Demo A demo of supported survey question types' }).click();
 
   // Check for introduction page
   const introText = await page.getByText('Welcome to our study. This is an example survey study. It asks basic questions o');
@@ -22,4 +22,4 @@ test('test', async ({ page }) => {
   // Check that the thank you message is displayed
   const endText = await page.getByText('Thank you for completing the study. You may close this window now.');
   await expect(endText).toBeVisible();
-});
+});

tests/vlat.spec.ts

@@ -2,7 +2,8 @@ import { test, expect } from '@playwright/test';
 
 test('test', async ({ page }) => {
   await page.goto('/');
-  await page.getByRole('button', { name: 'VLAT (Visualization Literacy Assessment Test) A replicaiton of the VLAT study, using image stimuli.' }).click();
+  await page.getByRole('button', { name: 'VLAT (Visualization Literacy Assessment Test) A replication of the VLAT questionnaire, using image stimuli.' }).click();
+
   await page.getByRole('heading', { name: 'What is VLAT?' }).click();
   await page.getByRole('button', { name: 'Next' }).click();
 
@@ -18,4 +19,4 @@ test('test', async ({ page }) => {
 
   // Check that the thank you message is displayed
   await page.getByText('Thank you for completing the study. You may close this window now.').click();
-});
+});