From 0ef521fdd7ad5cf3c721cda1f14db8e8f9a428b6 Mon Sep 17 00:00:00 2001 From: Becky Gilbert Date: Thu, 17 Oct 2024 15:08:00 -0700 Subject: [PATCH 1/6] clarify optional vs required params for video-consent --- packages/record/README.md | 44 +++++++++++++++++++++------------------ 1 file changed, 24 insertions(+), 20 deletions(-) diff --git a/packages/record/README.md b/packages/record/README.md index 0c163b0..561662a 100644 --- a/packages/record/README.md +++ b/packages/record/README.md @@ -149,14 +149,18 @@ const videoConsent = { ### Parameters +Parameter names are shown below, along with their type and default value. If the +default value is _undefined_, then a value is required for that parameter. + #### Standard fields **`locale` [String | "en-us"]** -Set this parameter to the languages 2 letter code. In some cases, a regional -code will have to be provided as well. For example, we currently support english -only from the US region. Therefore, to get the US english translation you would -put "en-US" for the locale. We support the following language codes: +Optional parameter to set a two-letter language code for translation. In some +cases, a regional code will have to be provided as well. For example, we +currently support english only from the US region. Therefore, to get the US +english translation you would put "en-US" for the locale. We support the +following language codes: | Language | Region | Code | | -------------- | ------ | ----- | @@ -176,16 +180,16 @@ Which consent document template to use. If you are setting up a new study, we recommend using the most recent (highest number) of these options. Options: `consent_005` -**`additional_video_privacy_statement` [String]** +**`additional_video_privacy_statement` [String | ""]** Optional additional text for under header “Who can see our webcam recordings”. For cases where researchers ask for other specific permission to share videos, separate from the exit survey, or want to provide more detail or different language about Databrary sharing. -**`datause` [String]** +**`datause` [String | ""]** -Study-specific data use statement (optional). This will follow more general text +Optional study-specific data use statement. This will follow more general text like: “The research group led by [PIName] at [institution] will have access to video and other data collected during this session. We will also have access to your account profile, demographic survey, and the child profile for the child @@ -206,39 +210,39 @@ single planned study). Whether to include a section on GDPR. -**`gdpr_personal_data` [String]** +**`gdpr_personal_data` [String | ""]** List of types of personal information collected, for GDPR section only. Do not include special category information, which is listed separately. -**`gdpr_sensitive_data` [String]** +**`gdpr_sensitive_data` [String | ""]** List of types of special category information collected, for GDPR section only. Include all that apply: racial or ethnic origin; political opinions; religious or philosophical beliefs; trade union membership; processing of genetic data; -biometric data; health data; and/or sex life or sexual orientation information +biometric data; health data; and/or sex life or sexual orientation information. -**`PIName` [String]** +**`PIName` [String | _undefined_]** -Name of PI running this study +Name of PI running this study. **`include_databrary` [Boolean | false]** Whether to include a paragraph about Databrary under “Who can see our webcam recordings?”. -**`institution` [String]** +**`institution` [String | _undefined_]** Name of institution running this study (if ambiguous, list institution whose IRB -approved the study)’ +approved the study). -**`PIContact` [String]** +**`PIContact` [String | _undefined_]** Contact information for PI or lab in case of participant questions or concerns. This will directly follow the phrase “please contact”, so format accordingly: e.g., “the XYZ lab at xyz@science.edu” or “Mary Smith at 123 456 7890”. -**`payment` [String]** +**`payment` [String | _undefined_]** Statement about payment/compensation for participation, including a statement that there are no additional benefits anticipated to the participant. E.g., @@ -264,7 +268,7 @@ IRB has a hard restriction against even offering participants the option to share their videos more broadly, and in conjunction with the corresponding restriction of options in the exit survey! -**`procedures` [String]** +**`procedures` [String | _undefined_]** Brief description of study procedures. For consent templates 001 and 002, this should include any risks or a statement that there are no anticipated risks. @@ -278,7 +282,7 @@ child smile. We will ask you (the parent) to turn around to avoid influencing your child’s responses. There are no anticipated risks associated with participating.” -**`purpose` [String]** +**`purpose` [String | _undefined_]** Brief description of purpose of study - 1-2 sentences that describe what you are trying to find out. Language should be as straightforward and accessible as @@ -293,12 +297,12 @@ rights or remedies because of your participation in this research study. If you feel you have been treated unfairly, or you have questions regarding your rights as a research subject, you may contact [CONTACT INFO]. -**`risk_statement` [String]** +**`risk_statement` [String | ""]** Optional statement; if provided, it is displayed under a header “Are there any risks if you participate?”. -**`voluntary_participation` [String]** +**`voluntary_participation` [String | ""]** Optional additional text for under header “Participation is voluntary”. E.g., “There are two sessions in this study; you will be invited to complete another From 656085cd258042d112f84bb12a8f06073194fee1 Mon Sep 17 00:00:00 2001 From: Becky Gilbert Date: Thu, 17 Oct 2024 15:08:36 -0700 Subject: [PATCH 2/6] use default: undefined for required params --- packages/record/src/consentVideo.ts | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/packages/record/src/consentVideo.ts b/packages/record/src/consentVideo.ts index de1c40c..8d79349 100644 --- a/packages/record/src/consentVideo.ts +++ b/packages/record/src/consentVideo.ts @@ -26,14 +26,14 @@ const info = { gdpr: { type: ParameterType.BOOL, default: false }, gdpr_personal_data: { type: ParameterType.STRING, default: "" }, gdpr_sensitive_data: { type: ParameterType.STRING, default: "" }, - PIName: { type: ParameterType.STRING, default: "" }, + PIName: { type: ParameterType.STRING, default: undefined }, include_databrary: { type: ParameterType.BOOL, default: false }, - institution: { type: ParameterType.STRING, default: "" }, - PIContact: { type: ParameterType.STRING, default: "" }, - payment: { type: ParameterType.STRING, default: "" }, + institution: { type: ParameterType.STRING, default: undefined }, + PIContact: { type: ParameterType.STRING, default: undefined }, + payment: { type: ParameterType.STRING, default: undefined }, private_level_only: { type: ParameterType.BOOL, default: false }, - procedures: { type: ParameterType.STRING, default: "" }, - purpose: { type: ParameterType.STRING, default: "" }, + procedures: { type: ParameterType.STRING, default: undefined }, + purpose: { type: ParameterType.STRING, default: undefined }, research_rights_statement: { type: ParameterType.STRING, default: "" }, risk_statement: { type: ParameterType.STRING, default: "" }, voluntary_participation: { type: ParameterType.STRING, default: "" }, From 0247d2aa43dcc740fcb206b7ecb1d4a2fd2ad263 Mon Sep 17 00:00:00 2001 From: CJ Green <44074998+okaycj@users.noreply.github.com> Date: Tue, 22 Oct 2024 14:04:29 -0400 Subject: [PATCH 3/6] Moved optional and required parameters to their own documentation section --- packages/record/README.md | 128 +++++++++++++++++++------------------- 1 file changed, 65 insertions(+), 63 deletions(-) diff --git a/packages/record/README.md b/packages/record/README.md index 561662a..9e35f13 100644 --- a/packages/record/README.md +++ b/packages/record/README.md @@ -152,7 +152,63 @@ const videoConsent = { Parameter names are shown below, along with their type and default value. If the default value is _undefined_, then a value is required for that parameter. -#### Standard fields +#### Required + +**`PIName` [String | _undefined_]** + +Name of PI running this study. + +**`institution` [String | _undefined_]** + +Name of institution running this study (if ambiguous, list institution whose IRB +approved the study). + +**`PIContact` [String | _undefined_]** + +Contact information for PI or lab in case of participant questions or concerns. +This will directly follow the phrase “please contact”, so format accordingly: +e.g., “the XYZ lab at xyz@science.edu” or “Mary Smith at 123 456 7890”. + +**`payment` [String | _undefined_]** + +Statement about payment/compensation for participation, including a statement +that there are no additional benefits anticipated to the participant. E.g., +“After you finish the study, we will email you a $5 BabyStore gift card within +approximately three days. To be eligible for the gift card your child must be in +the age range for this study, you need to submit a valid consent statement, and +we need to see that there is a child with you. But we will send a gift card even +if you do not finish the whole study or we are not able to use your child’s +data! There are no other direct benefits to you or your child from +participating, but we hope you will enjoy the experience.” + +This section is by default titled “Are there any benefits to your family?”; it +should only include information about benefits and compensation. If your IRB +prefers to combine risk/benefit information, you can change this to something +like “What are the risks and benefits if you participate?” and include both +here, then omit the risk_statement. + +**`procedures` [String | _undefined_]** + +Brief description of study procedures. For consent templates 001 and 002, this +should include any risks or a statement that there are no anticipated risks. +(For consent template 003, that is included in payment). We add a statement +about the duration (from your study definition) to the start (e.g., “This study +takes about 10 minutes to complete”), so you don’t need to include that. It can +be in third person or addressed to the parent. E.g., “Your child will be shown +pictures of lots of different cats, along with noises that cats make like +meowing and purring. We are interested in which pictures and sounds make your +child smile. We will ask you (the parent) to turn around to avoid influencing +your child’s responses. There are no anticipated risks associated with +participating.” + +**`purpose` [String | _undefined_]** + +Brief description of purpose of study - 1-2 sentences that describe what you are +trying to find out. Language should be as straightforward and accessible as +possible! E.g., “Why do babies love cats? This study will help us find out +whether babies love cats because of their soft fur or their twitchy tails.” + +#### Optional **`locale` [String | "en-us"]** @@ -222,44 +278,11 @@ Include all that apply: racial or ethnic origin; political opinions; religious or philosophical beliefs; trade union membership; processing of genetic data; biometric data; health data; and/or sex life or sexual orientation information. -**`PIName` [String | _undefined_]** - -Name of PI running this study. - **`include_databrary` [Boolean | false]** Whether to include a paragraph about Databrary under “Who can see our webcam recordings?”. -**`institution` [String | _undefined_]** - -Name of institution running this study (if ambiguous, list institution whose IRB -approved the study). - -**`PIContact` [String | _undefined_]** - -Contact information for PI or lab in case of participant questions or concerns. -This will directly follow the phrase “please contact”, so format accordingly: -e.g., “the XYZ lab at xyz@science.edu” or “Mary Smith at 123 456 7890”. - -**`payment` [String | _undefined_]** - -Statement about payment/compensation for participation, including a statement -that there are no additional benefits anticipated to the participant. E.g., -“After you finish the study, we will email you a $5 BabyStore gift card within -approximately three days. To be eligible for the gift card your child must be in -the age range for this study, you need to submit a valid consent statement, and -we need to see that there is a child with you. But we will send a gift card even -if you do not finish the whole study or we are not able to use your child’s -data! There are no other direct benefits to you or your child from -participating, but we hope you will enjoy the experience.” - -This section is by default titled “Are there any benefits to your family?”; it -should only include information about benefits and compensation. If your IRB -prefers to combine risk/benefit information, you can change this to something -like “What are the risks and benefits if you participate?” and include both -here, then omit the risk_statement. - **`private_level_only` [Boolean | false]** Whether to describe only the “private” video privacy level under the heading @@ -268,28 +291,7 @@ IRB has a hard restriction against even offering participants the option to share their videos more broadly, and in conjunction with the corresponding restriction of options in the exit survey! -**`procedures` [String | _undefined_]** - -Brief description of study procedures. For consent templates 001 and 002, this -should include any risks or a statement that there are no anticipated risks. -(For consent template 003, that is included in payment). We add a statement -about the duration (from your study definition) to the start (e.g., “This study -takes about 10 minutes to complete”), so you don’t need to include that. It can -be in third person or addressed to the parent. E.g., “Your child will be shown -pictures of lots of different cats, along with noises that cats make like -meowing and purring. We are interested in which pictures and sounds make your -child smile. We will ask you (the parent) to turn around to avoid influencing -your child’s responses. There are no anticipated risks associated with -participating.” - -**`purpose` [String | _undefined_]** - -Brief description of purpose of study - 1-2 sentences that describe what you are -trying to find out. Language should be as straightforward and accessible as -possible! E.g., “Why do babies love cats? This study will help us find out -whether babies love cats because of their soft fur or their twitchy tails.” - -**`research_rights_statement` [String]** +**`research_rights_statement` [String | ""]** Statement about rights of research subjects and how to contact IRB. For instance, MIT’s standard language is: You are not waiving any legal claims, @@ -320,27 +322,27 @@ in the Terms of Use! If it really won’t be possible to use Lookit without maki more changes, please let us know before using the following fields to further customize the consent form: -**`purpose_header` [String]** +**`purpose_header` [String | ""]** Custom alternate header for the section on study purpose. -**`procedures_header` [String]** +**`procedures_header` [String | ""]** Custom alternate header for the section on study procedures. -**`participation_header` [String]** +**`participation_header` [String | ""]** Custom alternate header for the section on participation being voluntary. -**`benefits_header` [String]** +**`benefits_header` [String | ""]** Custom alternate header for the section on benefits/compensation. -**`risk_header` [String]** +**`risk_header` [String | ""]** Custom alternate header for risks section. -**`summary_statement` [String]** +**`summary_statement` [String | ""]** Statement inserted at the beginning of the consent form, right after “Researchers led by … are running this study … on Lookit.” Please only use this @@ -376,7 +378,7 @@ Whether to prompt only the adult for consent for themselves to participate, rather than also referencing a child. This is for occasional studies running an adult comparison group. -**`consent_statement_text` [String]** +**`consent_statement_text` [String | ""]** Replace the default spoken consent statement with your custom text. From 142623dd92f0455193f05da2c5922bd3edcefe0c Mon Sep 17 00:00:00 2001 From: CJ Green <44074998+okaycj@users.noreply.github.com> Date: Tue, 22 Oct 2024 14:08:54 -0400 Subject: [PATCH 4/6] Update how parameters are formatted on exit survey --- packages/surveys/README.md | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/packages/surveys/README.md b/packages/surveys/README.md index dcb66fe..0e5675a 100644 --- a/packages/surveys/README.md +++ b/packages/surveys/README.md @@ -31,9 +31,18 @@ const exitSurvey = { type: chsSurvey.ExitSurveyPlugin }; ### Parameters -| Parameter | Type | Default Value | Description | -| ----------------------------- | ------- | ------------- | -------------------------------------------------------- | -| show_databrary_options | boolean | true | Show question about sharing collected data on Databrary. | -| include_withdrawal_example | boolean | true | Include an example in withdrawal question text. | -| private_level_only | boolean | false | Only show "private" on use of media question. | -| additional_video_privacy_text | string | "" | Add custom video privacy text to privacy question. | +**`show_databrary_options` [Boolean | true]** + +Show question about sharing collected data on Databrary. + +**`include_withdrawal_example` [Boolean | true]** + +Include an example in withdrawal question text. + +**`private_level_only` [Boolean | false]** + +Only show "private" on use of media question. + +**`additional_video_privacy_text` [String | ""]** + +Add custom video privacy text to privacy question. From e34cd6c2cbbde3c7720b0742fb868225b8d4bb6e Mon Sep 17 00:00:00 2001 From: CJ Green <44074998+okaycj@users.noreply.github.com> Date: Tue, 22 Oct 2024 14:25:08 -0400 Subject: [PATCH 5/6] Add "Optional" to other packages parameter sections. --- packages/record/README.md | 2 ++ packages/surveys/README.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/packages/record/README.md b/packages/record/README.md index 9e35f13..c79be74 100644 --- a/packages/record/README.md +++ b/packages/record/README.md @@ -21,6 +21,8 @@ const videoConfig = { type: chsRecord.VideoConfigPlugin }; ### Parameters +#### Optional + **`troubleshooting_intro` [HTML String]** Optional text to add at the start of the "Setup tips and troubleshooting" diff --git a/packages/surveys/README.md b/packages/surveys/README.md index 0e5675a..9ccb86c 100644 --- a/packages/surveys/README.md +++ b/packages/surveys/README.md @@ -31,6 +31,8 @@ const exitSurvey = { type: chsSurvey.ExitSurveyPlugin }; ### Parameters +#### Optional + **`show_databrary_options` [Boolean | true]** Show question about sharing collected data on Databrary. From 2e35efa2e352a4320083ee7ab98526ea2e3f2309 Mon Sep 17 00:00:00 2001 From: CJ Green <44074998+okaycj@users.noreply.github.com> Date: Tue, 22 Oct 2024 14:29:03 -0400 Subject: [PATCH 6/6] Force poetry to use python 3.13 --- makefile | 1 + 1 file changed, 1 insertion(+) diff --git a/makefile b/makefile index ddd4786..eb028fd 100644 --- a/makefile +++ b/makefile @@ -7,6 +7,7 @@ build: poetry poetry: poetry check poetry self update + poetry env use 3.13 poetry update --sync clean: