lookit / lookit-docs

Documentation for Lookit project, including use of platform and lookit-api, ember-lookit-frameplayer, and exp-addons repos.
MIT License
2 stars 367 forks source link

Standardizing the 100-word preview summaries displayed in study grid #310

Open msheskin opened 1 year ago

msheskin commented 1 year ago

Researchers have many different approaches to writing the "under 100 words" preview summary that appears on the listing page of available studies. That is a field that was added more recently than the "short description" and "purpose" fields, and we have not updated instructions, self-review checklists, or admin review to reflect it.

Thus, researchers have chosen a lot of different approaches. For example, they have different mixes of "what" and "purpose". And some just say "This study will take place on a video call, live with a researcher!" and nothing more. And there are many more variations!

For some useful standardization, one idea is that we require the following template (exceptions allowable for good reasons): [optional detail about study delivery] + [major detail about what happens] + [optional major detail about purpose]

Below is what it would look like for a few examples. In each example, both optional bits are included, but some studies might not have anything to include in the first bit (especially if it was just a "standard" internal study):

This should be updated in multiple places:

becky-gilbert commented 1 year ago

Thanks @msheskin, I can take care of this one too following approval/comments from @mekline.