From 54d2e83a4175c42587e9c686bbe8d4105781707b Mon Sep 17 00:00:00 2001 From: Becky Gilbert Date: Mon, 23 Dec 2024 12:45:10 -0800 Subject: [PATCH 1/3] update welcome section to explain how tutorial works for different study types --- docs/source/tutorial-access.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/source/tutorial-access.rst b/docs/source/tutorial-access.rst index f79c125..6d69051 100644 --- a/docs/source/tutorial-access.rst +++ b/docs/source/tutorial-access.rst @@ -7,9 +7,14 @@ Welcome ---------- -Welcome to the Children Helping Science (CHS) tutorial! In this tutorial you will work through a series of exercises intended to build all the skills you'll need to run your own Lookit study on the CHS platform. By the end of the tutorial, you will be able to create a participant-friendly study that includes a survey and test trials, assign children to different experimental conditions, test and troubleshoot your study, download study data, contact participants, use and even edit this documentation! +Welcome to the Children Helping Science (CHS) tutorial! In this tutorial you will work through a series of exercises intended to build all the skills you'll need to run your own study on the CHS platform. By the end of the tutorial, you will be able to create a participant-friendly study that includes a survey and test trials, assign children to different experimental conditions, test and troubleshoot your study, download study data, contact participants, use and even edit this documentation! -This tutorial was written for researchers who will be building a Lookit study, but most steps are also applicable for researchers who will be building a jsPsych study or sharing a link to an external study instead. +.. admonition:: Who should do this tutorial? + + This tutorial was mostly written for researchers who will be building a Lookit study, but it's also applicable for researchers who will be building a jsPsych study or sharing a link to an external study instead. We've flagged the different points in the tutorial that you may want to do/skip if you're only interested in certain study types. Specifically: + + - In **Step 3: Create a study**, you can choose to create an internal Lookit or jsPsych study, or skip this section if you're running an external study. + - In **Step 4: Managing study data**, if you're only interested in running external studies then you'll be able to skip the consent review process and ignore some of the data types, like video recordings and task data. This tutorial should take between 5 and 10 hours to complete, and does not assume any familiarity with programming. There is a mix of step-by-step directions and exercises to complete. It's the best way to get started with creating and managing a Lookit study, and a good first task to give to an RA who will be designing studies. Note that it does **not** cover issues like participant recruitment and IRB approval, just the technical side of things. From d33a0ec6a9d1b3b4fdf28de7d0afe4d7cb1ace50 Mon Sep 17 00:00:00 2001 From: Becky Gilbert Date: Mon, 23 Dec 2024 13:13:04 -0800 Subject: [PATCH 2/3] fix formatting and add links to CHS pages --- docs/source/tutorial-access.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/source/tutorial-access.rst b/docs/source/tutorial-access.rst index 6d69051..cef192d 100644 --- a/docs/source/tutorial-access.rst +++ b/docs/source/tutorial-access.rst @@ -66,8 +66,6 @@ Exercises 1. Say hello in the "tutorial" channel of the Lookit/CHS Slack workspace. -2. Get a feel for the participant experience by trying out one of the "template" studies! At https://childrenhelpingscience.com/exp/studies/, find a study labeled TEMPLATE from the lab "Demo lab." Click on it and then click "Preview study" to see how it would work if you were a -participant! You may need to add a child profile and complete your demographic survey, -which you can do from https://childrenhelpingscience.com/account/manage/. +2. Get a feel for the participant experience by trying out one of the "template" studies! From the `"Manage Studies" page `__, find a study that is part of the "Demo lab" and has "[TEMPLATE]" in the title, such as `"Baby Tetris" `__ or `Can they both be right?" `__. Click on it and then click "Preview study" to see how it would work if you were a participant! You may need to add a child profile and complete your demographic survey, which you can do from the `"Manage Account" page `__ (click your name in the top right, then "Manage Account"). 3. [Extra credit] If you have young kids, take part in a currently-running study on the production server (https://childrenhelpingscience.com) - the experience is different with a squirming kid in your lap! Please enter only actual, not made-up, data on the production server - you are participating in real research here. (If you're curious but don't have a child in the age range, feel free to contact the lab and ask if it's ok to check it out--generally they can deal with that easily, but a heads up is helpful.) From 88378cb7c50926847a77a3e17ddcf4995813b855 Mon Sep 17 00:00:00 2001 From: Becky Gilbert Date: Mon, 23 Dec 2024 13:32:37 -0800 Subject: [PATCH 3/3] add links and explain how to get to different pages --- docs/source/tutorial-access.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/tutorial-access.rst b/docs/source/tutorial-access.rst index cef192d..e576777 100644 --- a/docs/source/tutorial-access.rst +++ b/docs/source/tutorial-access.rst @@ -66,6 +66,6 @@ Exercises 1. Say hello in the "tutorial" channel of the Lookit/CHS Slack workspace. -2. Get a feel for the participant experience by trying out one of the "template" studies! From the `"Manage Studies" page `__, find a study that is part of the "Demo lab" and has "[TEMPLATE]" in the title, such as `"Baby Tetris" `__ or `Can they both be right?" `__. Click on it and then click "Preview study" to see how it would work if you were a participant! You may need to add a child profile and complete your demographic survey, which you can do from the `"Manage Account" page `__ (click your name in the top right, then "Manage Account"). +2. Get a feel for the participant experience by trying out one of the "template" studies! After logging with your researcher account, click the "Experimenter" button at the top to get to the `"Manage Studies" page `__. Then find a study that is part of the "Demo lab" and has "[TEMPLATE]" in the title, such as `Baby Tetris `__ or `Can they both be right? `__. Click on it and then click "Preview study" to see how it would work if you were a participant! You may need to add a child profile and complete your demographic survey, which you can do from the `"Manage Account" page `__ (click your name in the top right, then "Manage Account"). -3. [Extra credit] If you have young kids, take part in a currently-running study on the production server (https://childrenhelpingscience.com) - the experience is different with a squirming kid in your lap! Please enter only actual, not made-up, data on the production server - you are participating in real research here. (If you're curious but don't have a child in the age range, feel free to contact the lab and ask if it's ok to check it out--generally they can deal with that easily, but a heads up is helpful.) +3. [Extra credit] If you have young kids, take part in a currently-running study as a real participant! You can log in with your researcher account, but make sure that you're on the family-facing part of the website by clicking "CHS Home" at the top, then go to the `"Studies" page `__. The experience is different with a squirming kid in your lap! Please enter only actual, not made-up, data on the production website - you are participating in real research here. (If you're curious but don't have a child in the age range, feel free to contact the lab and ask if it's ok to check it out - generally they can deal with that easily, but a heads up is helpful.)