USWDS - Guidance: Create new public research recruitment page #2424

mejiaj · 2024-01-10T18:03:46Z

Summary

Create page for research recruitment (general public). New page contains information for general public on research recruitment.

Content docs (Used internal gDocs 🔒 to make these changes):

New page: Usability research program recruitment page (DRAFT)
Research landing page: USWDS Research page - Content

New URLs

/about/research/recruitment/general-public/
/research/recruitment/public (redirect)

Screenshot

Related issue

Closes #2400.

Preview link

Preview links:

Research | How to participate in research
Research | Recruitment for general public ✨ New page

Problem statement

Research landing needs to link to new Research recruitment page for the general public.

Solution

Created a new section in About for research and a new page for general recruitment. This new page uses usa graphic list component to make the expectations more scannable.

This new component was created with two partials:

component-graphic-list.html
component-graphic-list-item.html

This approach allows flexibility in how this component is used throughout the site. For example, we have more control over columns and how that content wraps.

Possible limitations

Headers might need to be customizable to follow page order.
Images outside of usa-icons might need to be passed.
Current graphic list implementation has scaffolding in markdown. Editing might be difficult for non-technical folks.

Major changes

Created a section for research [1f4376b].
Created graphic list components [e114249].

Testing and review

There's a new link in Research sidenav - Recruitment for general public.
How to participate in research on Research landing has a link to new page for general public.
New page for General public recruitment - Recruitment for general public.

- Remove commented subnav - Overview page: remove quotes from recruitment `href`

- Create partials for graphic list - Format HTML in icon partial - Update list icon size

mejiaj · 2024-01-11T17:03:54Z

pages/about/research/recruitment/general-public.md

@@ -0,0 +1,77 @@
+---
+permalink: /about/research/recruitment/general-public/


Tip
The end / matters in permalink. Otherwise this produces inconsistent results on local vs cloud pages environment.

mejiaj · 2024-01-11T17:04:18Z

pages/about/research/overview.md

@@ -70,6 +72,15 @@ Explore some of our past research work:
 - [Inclusive Design Patterns research]({{ site.baseurl }}/together/) (November 2022): Reducing barriers to participation in common government interactions.
 - [Transforming the American digital experience]({{ site.baseurl }}/next/) (March 2021): Supporting emergency response efforts related to the COVID-19 and identifying strategies for advancing the design system through agency collaboration.

+## How to participate in research
+
+{:.border-top-2px .border-base-lighter .padding-top-1}


Border added to keep it consistent with Research landing page.

pages/about/research/recruitment/general-public.md

jaclinec · 2024-01-11T21:46:30Z

I think it's looking great! My main feedback is we should tweak the "What to expect" section. I think the content under "Scheduling and information" paired with what's in "Time" is confusing - we should just put scheduling info in the "Time" section.

I propose these changes:

Information: A member of our team will share details about that particular research effort with you so you know what to expect, and might ask you to fill out a brief consent form.
Time: Sessions usually take 1 hour. We will provide a few date and time options to schedule with you.
Payment: We generally pay $75 per session, depending on the length of the session.
Technology needed: You typically will need a laptop, tablet, or phone, and internet access.

@annepetersen what do you think of these proposed changes?

annepetersen · 2024-01-11T22:37:04Z

@jaclinec Very glad you provided the revised version: the description in the paragraph seemed perhaps more confusing to me.

But the revised version generally looks good: my only questions are if there's a better word to use than "Information" for that section, and if there's a reason you drop the "to hour and twenty" and "to $100" other than conciseness?

jaclinec · 2024-01-11T22:59:05Z

Hmm, not sure of a better word for "Information" - maybe "Details"?

I dropped the "hour and twenty" and the "$100" because I think we all decided that we will aim for study sessions that take no longer than 1 hour going forward. So, we likely won't pay more than $75 unless we have another reason to do so.

annepetersen · 2024-01-11T23:10:07Z

Ah, that's right, good reminder.

I also came up short on a better word: not sure Details is much better. I'm cool with getting this live with Information and asking our content strategists to take a look when they can. Thanks!

- Redirect was added to make it easier to reach.

Border added to header with measure to try to limit the width. Otherwise it'll span the full width of the content and looks uneven.

mejiaj · 2024-02-09T14:59:39Z

@mahoneycm, @annepetersen, @jaclinec I've added new content, addressed comments, and updated the PR description. Thanks for the suggestions.

This is ready for another review.

jaclinec

Looks great - I don't have any suggested changes. Nice work!

mejiaj · 2024-02-12T17:38:45Z

@thisisdano ready for your review. Blocked until #2466 is merged.

mahoneycm

Looks great! Great work James

annepetersen · 2024-02-13T19:41:06Z

@thisisdano, I've reviewed this thoroughly. Would you still like to, or can we merge this in order to start recruitment from it?

…cruitment-page

thisisdano · 2024-02-20T19:36:25Z

Merge over pa11y crash

mejiaj added 7 commits January 10, 2024 11:06

Research: create new section

1f4376b

Add placeholder for recruitment page

d71aaf8

Create general recruitment page. Closes #2400.

1b8f9bc

Add PR number to changelog

3b72fe6

Cleanup frontmatter

8f632a7

- Remove commented subnav - Overview page: remove quotes from recruitment `href`

Add graphic list to "What to expect"

e114249

- Create partials for graphic list - Format HTML in icon partial - Update list icon size

Add section borders to be consistent with Research landing

073c5a3

This comment was marked as outdated.

Sign in to view

mejiaj commented Jan 11, 2024

View reviewed changes

pages/about/research/recruitment/general-public.md Outdated Show resolved Hide resolved

mejiaj requested review from thisisdano, mahoneycm, amyleadem, jaclinec and annepetersen January 11, 2024 17:07

mejiaj marked this pull request as ready for review January 11, 2024 17:07

This comment was marked as resolved.

Sign in to view

mejiaj assigned jaclinec Jan 16, 2024

This comment was marked as resolved.

Sign in to view

mejiaj added 2 commits February 9, 2024 08:19

General public: add latest content with new redirect

818cfd3

- Redirect was added to make it easier to reach.

General public: Remove duplicate header & adjust border

9c98d1b

Border added to header with measure to try to limit the width. Otherwise it'll span the full width of the content and looks uneven.

mejiaj requested a review from mahoneycm February 9, 2024 14:58

jaclinec approved these changes Feb 9, 2024

View reviewed changes

mejiaj removed the request for review from amyleadem February 12, 2024 17:39

mahoneycm approved these changes Feb 12, 2024

View reviewed changes

mejiaj added 2 commits February 14, 2024 11:10

Merge branch 'main' of github.com:uswds/uswds-site into jm-feature-re…

55bb852

…cruitment-page

Merge branch 'main' of github.com:uswds/uswds-site into jm-feature-re…

139b1a7

…cruitment-page

thisisdano approved these changes Feb 20, 2024

View reviewed changes

thisisdano merged commit f865fab into main Feb 20, 2024
9 of 11 checks passed

thisisdano deleted the jm-feature-recruitment-page branch February 20, 2024 19:36

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

USWDS - Guidance: Create new public research recruitment page #2424

USWDS - Guidance: Create new public research recruitment page #2424

mejiaj commented Jan 10, 2024 •

edited

Loading

This comment was marked as outdated.

mejiaj Jan 11, 2024

mejiaj Jan 11, 2024 •

edited

Loading

This comment was marked as resolved.

jaclinec commented Jan 11, 2024

annepetersen commented Jan 11, 2024

jaclinec commented Jan 11, 2024

annepetersen commented Jan 11, 2024

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

mejiaj commented Feb 9, 2024

jaclinec left a comment

mejiaj commented Feb 12, 2024

mahoneycm left a comment

annepetersen commented Feb 13, 2024

thisisdano commented Feb 20, 2024

		@@ -0,0 +1,77 @@
		---
		permalink: /about/research/recruitment/general-public/

USWDS - Guidance: Create new public research recruitment page #2424

USWDS - Guidance: Create new public research recruitment page #2424

Conversation

mejiaj commented Jan 10, 2024 • edited Loading

Summary

Related issue

Preview link

Problem statement

Solution

Major changes

Testing and review

This comment was marked as outdated.

mejiaj Jan 11, 2024

Choose a reason for hiding this comment

mejiaj Jan 11, 2024 • edited Loading

Choose a reason for hiding this comment

This comment was marked as resolved.

jaclinec commented Jan 11, 2024

annepetersen commented Jan 11, 2024

jaclinec commented Jan 11, 2024

annepetersen commented Jan 11, 2024

This comment was marked as resolved.

This comment was marked as resolved.

This comment was marked as resolved.

mejiaj commented Feb 9, 2024

jaclinec left a comment

Choose a reason for hiding this comment

mejiaj commented Feb 12, 2024

mahoneycm left a comment

Choose a reason for hiding this comment

annepetersen commented Feb 13, 2024

thisisdano commented Feb 20, 2024

mejiaj commented Jan 10, 2024 •

edited

Loading

mejiaj Jan 11, 2024 •

edited

Loading