Update CHS/Lookit terms and add jsPsych experiment runner #437

becky-gilbert · 2024-11-07T22:58:55Z

This PR does the following:

Updates the language so that "Children Helping Science/CHS" refers to the platform/site, and "Lookit" only refers to the EFP experiment runner.
Adds the jsPsych study type and experiment runner option. (The CHS jsPsych documentation is still pretty minimal, but I made changes throughout the site to mention that it exists).
Updates the architecture page to include the lookit-jspsych repo.
Restructured the Tutorial section so that there's a single "Create a study" step with nested options: either Lookit or jsPsych. The other tutorial steps are relevant to both internal experiment runners.
Adds a very basic Hello World CHS-jsPsych tutorial for the jsPsych option in the "Create a study" step in the main tutorial.
Moves the study "design" fields (i.e. the fields that are specific to the study type) out of the study "details" (ad) page and into their own page. This was a hang-over from when these fields used to be all in the same form, regardless of study type, and now they're split into two separate forms.
Updates URLs from our old production and staging sites (mit.edu) to new domains.
Updates our contact email from lookit at mit.edu to CHS at gmail.

To do:

I still need to make separate PRs with the following:

Update the docs theme to include "tabs" (or other horizontally-placed links) at the top of the Table of Contents / Navigation, which will contain links to the EFP docs ("Lookit EFP") and the lookit-jspsych docs ("jsPsych"). Update RTD theme and add jsPsych tab #439
Add the same tabs to the EFP and lookit-jspsych docs (these PRs will be in those two repositories).
Add a "jsPsych studies" section in the docs navigation (analogous to the "Lookit studies" section), with a few pages about the CHS jsPsych experiment runner, links to jsPsych docs and our docs/tutorial, limitations (e.g. list the set of packages/versions that are available), release notes. Add jspsych studies section #438
Replace the static lookit-jspsych docs links with intersphinx mapping links.

…kit, switching to CHS email and URLs

…spsych tutorials

… details/design pages, move study design fields from study details page, add jsPsych info

…experiment runner

…ials

…o all study types, add new study design page

…sign page) and add study type section with jsPsych option

…o Study Ad/Design, add Design options for jsPsych and external

… to tutorial

… update subprocessor info

…view

becky-gilbert · 2024-11-07T23:10:46Z

docs/source/faq.rst

+What is the name of this platform? Children Helping Science or Lookit?
+---------------------------------------------------------------------------
+
+Children Helping Science (CHS) is the name of the website, and Lookit is the name of the 'default' experiment runner.
+
+The whole platform was called Lookit when it was first created. In May 2023, it merged with a separate-but-similar project called Children Helping Science. Now, the platform (website) is called Children Helping Science (CHS), and the internal experiment runner is called Lookit. So if you're used to using the "Lookit" name for the whole site, you'll still see that term used to refer to a specific study type, i.e. studies that use the ember-lookit-frameplayer. You'll also see some remnants of the previous naming system in, for instance, the names of our open-source code repositories - the codebase for the CHS website is "lookit-api" and the CHS documentation is "lookit-docs".
+
+What is the name of the internal experiment runner? LoOkIt, Look!t, LooKit?
+--------------------------------------------------------------------------------------


@mekline new FAQ section about CHS vs Lookit.

docs/source/other-learning-materials.rst

docs/source/researchers-manage-studies.rst

docs/source/community-involvement.rst

subtle changes to Lookit/CHS nomenclature

slight language update

docs/source/community-participant-recruitment.rst

docs/source/contribute-architecture-overview.rst

Updating some nomenclature information - Becky, can you please check for any link display issues?

docs/source/features.rst

docs/source/tutorial-create-study.rst

mekline

Ready to go! Epic, nice job :)

docs/source/install-django-project.rst

docs/source/researchers-edit-design.rst

docs/source/tutorial-jspsych/tutorial-jspsych-first-study.rst

becky-gilbert added 17 commits November 4, 2024 13:53

first pass at adding jsPsych experiment runner, clarifying CHS vs Loo…

3c16211

…kit, switching to CHS email and URLs

move tutorial pages into separate lookit tutorial section

9c3e2c6

add jsPsych tutorial pages nested in tutorial step 3

4b2f481

add target label and update tutorial step number

ee7fa3d

add new tutorial step 3 create study section for nesting lookit and j…

3326150

…spsych tutorials

add target and update tutorial step number

19fbb88

update tutorial step number

c3816b6

add new edit study design page to correspond with our now-split study…

68b9d28

… details/design pages, move study design fields from study details page, add jsPsych info

update home page and TOC with CHS vs Lookit terms and to add jsPsych …

7d38884

…experiment runner

update TOC with new create study step and nested lookit/jspsych tutor…

4bc0582

…ials

move study fields page from Lookit into Using CHS since these apply t…

230a9ac

…o all study types, add new study design page

remove fields that are specific to study type (now in on the study de…

a59ea8b

…sign page) and add study type section with jsPsych option

update lookit-api installation page with jsPsych and EFP RecordRTC info

836a420

update CHS vs Lookit terms, update URLs, split Study Edit section int…

a3ab316

…o Study Ad/Design, add Design options for jsPsych and external

update CHS vs Lookit terms, CHS URLs, add jsPsych study type and link…

0ac5df0

… to tutorial

update CHS vs Lookit terms, CHS links, add jsPsych experiment runner,…

2496344

… update subprocessor info

update with CHS vs Lookit terms, and add jsPsych to architecture over…

9a49804

…view

becky-gilbert requested a review from mekline November 7, 2024 22:59

becky-gilbert self-assigned this Nov 7, 2024

becky-gilbert requested review from bleonar5, okaycj and sradifera November 7, 2024 23:02

becky-gilbert commented Nov 7, 2024

View reviewed changes

docs/source/other-learning-materials.rst Show resolved Hide resolved

becky-gilbert commented Nov 7, 2024

View reviewed changes

docs/source/researchers-manage-studies.rst Show resolved Hide resolved

fix typo

7062e35

mekline reviewed Nov 8, 2024

View reviewed changes

docs/source/community-involvement.rst Outdated Show resolved Hide resolved

mekline added 2 commits November 8, 2024 10:18

Update README.md

213b004

subtle changes to Lookit/CHS nomenclature

Update community-irb-and-legal-information.rst

add7820

slight language update

mekline reviewed Nov 8, 2024

View reviewed changes

docs/source/community-participant-recruitment.rst Outdated Show resolved Hide resolved

mekline reviewed Nov 8, 2024

View reviewed changes

docs/source/contribute-architecture-overview.rst Outdated Show resolved Hide resolved

Update faq.rst

a2e4a8c

Updating some nomenclature information - Becky, can you please check for any link display issues?

mekline reviewed Nov 8, 2024

View reviewed changes

docs/source/features.rst Outdated Show resolved Hide resolved

mekline reviewed Nov 8, 2024

View reviewed changes

docs/source/tutorial-create-study.rst Outdated Show resolved Hide resolved

mekline approved these changes Nov 8, 2024

View reviewed changes