Research: Test: Issue Template: Research: Distribute & Collect Informed Consent Documents (18 yrs +)

[pandanista]

Dependencies

We need to have a research plan in order to test the Consent Template. Any research plan that has a consent component for 18+ participants will work. If the following research plans/timelines are ready you can use those, or if another research plan comes up, that fits the bill, use that.

• Research plan needs to be finished before testing using RP020:
  • TWE: Create Research Plan for RP20 #320
• Research plan timeline needs to be done before testing using RP020
  • TWE: IS22: RP020: Research Plan Timeline: Create #371

Overview

We need to test the Distribute & Collect Informed consent Documents Issue Template so that researchers can start making distribute and collect informed consent documents issues on/for the various research plans/tasks

Details

We expect that the template you are testing will need some improvement and the fact that you don't know much about the project is a benefit here, because it's likely that the person making the template can overlook something that they already know how to do, but should be fully explained in the template so that people can do the work independently.

Action Items

• Go to the draft issue template in a comment on the issue where the draft you are testing is being created in Resource 1.01
• Copy the draft
  • Click on three dots
  • Choose edit
  • Select the contents (Use Select All Mac: ⌘+A or PC: Ctrl+A)
  • Copy the contents (Use Copy Mac: ⌘+C or PC: Ctrl+C)
• Create the new issue
  • Open a new blank issue template (Resource 1.02)
• Use the template to customize the issue
  • Paste the draft into the new issue body
  • Replace the title with the following text

    `[TEST]` 
    

  • Add the title from Resource 1.03 after the text: [TEST]. This part is the title that would have been provided if the issue was made from a template instead of this testing process.
  • Submit the new issue
• Add Labels to the new issue
  • Locate the labels associated with the template to be tested (see Resource 1.01)
    Example: See the highlighted section

    

  • Add all the labels associated with the template to be tested in the new issue you just submitted
    • Under Labels, choose gear
    • Select each label you previously located from the template to be tested
  • Add feature: template test (step 3) label to the new issue you just submitted
• Add new issue to Project Board
  • Under Projects, choose gear , choose Repository, and choose TWE: Project Board
  • Under TWE: Project Board, choose the down arrow and change the status to In Progress
• Assign yourself the issue
  • Under Assignees, Choose No one - assign yourself
• Use the new issue to test the template
  • Follow the instructions in the new issue. Your goal is to test that the template is sufficient for creating the issue and working on it, so for the purposes of this test, you are the creator of the issue and the assignee.
  • If you have any questions about the instructions in this issue, leave a new comment below. Then move this issue to the Questions/Review column, and add ready for research lead label
  • When you have question or suggestions about the instructions in the new issue you are using to test the template, please:
    • leave comments in that new issue, @ messaging the person who made the template in your comment
    • move it to the Questions/Review column
    • add ready for research lead label
    • @ message the person who made the template in Slack with a link to your comment.
  • Review changes to the template made by author and repeat your review process until you are satisfied that it's ready for deployment
    • Leave a comment on the template issue and the new issue you created with your sign-off (@ messaging both the template author and the Research Lead)
    • Add the issues to the next Research team agenda (Resource 1.04) and @ messaging both the template author and the Research Lead via the team Slack channel with a link to the issue comments)

Research lead action items

• review the template again
  • if changes are needed, send back to author with notes
  • if no changes are needed, deploy template, close issues.
    • Add link to the finished template to Resource 2.01

Resources

Resources for creating this issue

• 1.01 TWE: Create Template Issue: TWE: Research: Consent Forms: Distribute & Collect (for participants over 18) #715 (comment)
• 1.02 Blank issue template
• 1.03 TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] Informed Consent Documents (18 yrs +): Distribute & Collect
• 1.04 TWE: UX Research Meeting Agenda #62

Resources gathered during the completion of this issue

• 2.01 Research: Distribute & Collect Consent Forms