Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TWE: HfLA Volunteer Research Plans and Goals Chart: Create #374

Closed
47 of 71 tasks
pandanista opened this issue Feb 24, 2023 · 10 comments
Closed
47 of 71 tasks

TWE: HfLA Volunteer Research Plans and Goals Chart: Create #374

pandanista opened this issue Feb 24, 2023 · 10 comments
Assignees
Labels
complexity: missing feature: overview feature: research All issues involving research p-feature: wiki Participant Type: HfLA Team member PBV: research all issues for the research team Research: RP002 Transferable Skills Research: RP020 Intern Interaction with HfLA teams role: UI/UX research size: 1pt Can be done in 6 hours

Comments

@pandanista
Copy link
Member

pandanista commented Feb 24, 2023

Overview

We need to update the Research Plans and Goals chart on Wiki with the research plan(s) info so we could provide an overview for external use.

During these tasks you will be asked to add link to the Resources/Instructions section, and that section is at the bottom of this issue (go view it now).

Action Items

Customize Resource Links

  • Customize Resource for the Research Plan's Google Drive Folder
    • Go to "Google Drive Folder: Research by Participant Type" (Resources # 1.01)
    • Choose "HfLA Volunteers" folder and right-click on the folder
    • Choose "Get Link"
    • Choose "Copy link" and "Done"
    • Choose "Edit" under the three dots to access the GitHub Write mode
    • Update Resource # 2.01 with the link you just copied. Place it into parentheses at the end of the line.
    • Choose "Update comment" in Github and make sure all the checkboxes above have been checked Screenshot 2023-02-21 at 6 47 15 PM
    • Identify if there is any research plan document in the folder (Resource # 2.01)
      • If the research plan(s) exists,
        1. Right-click on each research plan Google Doc
        2. Choose "Rename" and copy the texts
        3. Paste the texts in brackets in Resources as # 2.01.01, 2.01.02, 2.01.03, etc
        4. Again, right-click on the research plan Google Doc in Google Drive
        5. Choose "Get Link"
        6. Choose "Copy link" and "Done"
        7. Update Resources # 2.01.01, 2.01.02, 2.01.03, etc., with the link you just copied. Place it into parentheses at the end of the line.
      • If any research plan(s) is missing,
        • Choose the gear in the Labels section Screenshot 2023-04-19 at 8 06 27 PM
        • Put on the dependency label
        • Copy
        ### Dependencies
        - [ ] The research plan(s) needs to be created. See issue # 
        
        • Choose "Edit" under the three dots to access the GitHub Write mode
        • Paste what you just copied to the beginning of the issue above the Overview section
        • Choose Update comment Screenshot 2023-02-21 at 6 47 15 PM
        • Choose Issues located on the top of the GitHub page to open a new tab in your browser Screenshot 2023-06-15 at 5 18 07 PM
        • In the search bar, include the missing research plan number, i.e. RP001, to do a search to see if the research plan has an existing issue. Make sure to check both open and closed issue. Screenshot 2023-06-15 at 4 18 57 PM
        • If there is an existing issue for creating that research plan, add the issue number after "See issue # " in the dependencies section so we can track the status of the research plan issue
          • Assign the existing research plan issue to yourself if no one is assigned so you can start working on that since it is a dependency
        • If there is non existing issue for creating that research plan, create a new issue using research plan template
          • Customize the new issue using the missing research plan's number, RP###
          • Once the new issue is created, include the issue number after "See issue # " in the dependencies section
          • Assign the new issue to yourself so you can start working on the new issue since it is a dependency
        • Make a comment in this issue as an update to inform the team that there is a missing research plan and include the issue number for creating the research plan
        • Put this issue back to the icebox
        • Remove yourself from this issue
      • Choose "Update comment" in Github and make sure all the checkboxes above have been checked
  • Customize Resource for Wiki Page Link
    • Go to "Research Documents by Participant Type" section on the Research Output Overview Wiki Page (Resources # 1.02)
    • Choose HfLA Volunteers so it directs to the HfLA Volunteers Research Overview Wiki page
    • Copy the URL of HfLA Volunteers Research Overview Wiki page in the browser
    • Update Resource # 2.02 with the link you just copied. Place it into parentheses at the end of the line.
    • Choose "Update comment" in Github and make sure all the checkboxes above have been checked
  • Customize Resource for Research Plans and Goals Wiki Page
    • Select the hyperlink in the HfLA Volunteers Research Plans and Goals (public page) section on HfLA Volunteers Research Overview page so it directs to HfLA Volunteers Research Plans and Goals Wiki page
    • Copy the URL of HfLA Volunteers Research Plans & Goals Wiki page in the browser
    • Update Resource # 2.03 with the URL you just copied. Place it into parentheses at the end of the line.
    • Choose "Update comment" in Github and make sure all the checkboxes above have been checked
  • Customize the spreadsheet for generating the Research Plans and Goals chart
    • Open the template "TWE: Template: Research Plans and Goals Chart Spreadsheet" (Resources # 1.03)
    • Choose the "Use Template" button to save it to your own drive
    • Rename the file by following the steps:
      • Copy
      TWE: IS22: HfLA Volunteers Research Plans and Goals Chart Spreadsheet
      
      • Choose "File" > "Rename", and paste the texts you copied into the top field
        Screenshot 2023-01-30 at 1 35 41 PM Screenshot 2023-02-27 at 2 51 11 PM
    • Move the file into the Internship's shared drive in this Research Plan's Google Drive folder
      1. Choose File > Move (or Move icon)
      2. Choose the back arrow to access all your drives
      3. Choose Shared drives > Internships > Internships > Research > Research by Participant Type > HfLA Volunteers
      4. Choose "Move here"
      5. Choose "Move" when it asks if you want to change ownership to a shared drive
      6. Dismiss the notification that says the file is now in the shared drive
    • Update Resource # 2.04 link
      1. In the Research Plans and Goals Chart Spreadsheet, choose "Share" (upper right corner)
      2. Choose "Copy link" and "Done"
      3. Update Resource # 2.04 with the link you just copied. Place it into parentheses at the end of the line.
      4. Choose "Update comment" in Github and make sure all the checkboxes above have been checked

Customize the Research Plans and Goals Chart Spreadsheet

  • Open the Research Plans and Goals Chart Spreadsheet in Resources # 2.04 if it is not open
  • In "All with edit links" tab
    • Fill out Columns A - F based on research plan and roadmap doc, starting from Row 2 (Resources # 2.02 and # 2.01)
    • Add the links to the research plans in Column G
      1. Copy the matching research plan's URL from Resources 2.01's sub-section, such as 2.01.01
      2. In Column G, choose the cell that matches the research plan
      3. Click on the link icon Screenshot 2023-02-27 at 3 31 50 PM
      4. Paste the URL you copied into the text box. Update the URL by removing the /edit?usp=share_link string and add /preview at the end of the URL so all participants can view the document Screenshot 2023-02-27 at 3 32 18 PM
      5. Choose Apply
    • Add the link to the Google Form survey or script(s) if they exist in Column H and Column I
      1. Choose the folder linked in Resources # 2.01
      2. Open each research plan folder
      3. Choose the Google Form (could be a survey or an interview script depending on the research method used for the study) in the research plan folder
      4. Choose "Send" Screenshot 2023-02-27 at 6 07 11 PM
      5. Choose the link icon Screenshot 2023-02-27 at 6 07 31 PM and choose "Copy"
      6. In Column H, choose the cell that corresponds with the research plan
      7. Click on the link icon Screenshot 2023-02-27 at 3 31 50 PM
      8. Paste the URL you copied into the text box Screenshot 2023-02-27 at 3 32 18 PM
      9. Choose Apply
      10. Copy the URL from the browser tab in which the Google Form is open
      11. In Column I, choose the cell that corresponds with the research plan
      12. Click on the link icon Screenshot 2023-02-27 at 3 31 50 PM
      13. Paste the URL you copied from the browser into the text box Screenshot 2023-02-27 at 3 32 18 PM
      14. Choose Apply
    • If the Google Form survey/script (Column H) does not exist in research plan folders
      1. Make a comment in this issue as an update to let the team know the script(s) needs to be created and added in the Research Plan and Goals chart once it is available
      2. Check in with the team at the next research meeting to get an estimate on when the Google Form will be ready
  • If any of the research plans use interviews as the research method, update the "Interviews published version" tab
    1. In "All with edit links" tab, choose the filter in Research Method(s) (Column C) Screenshot 2023-02-27 at 7 08 02 PM
    2. Check "Interview" and uncheck the rest of methods Screenshot 2023-02-27 at 7 08 39 PM
    3. Choose "OK" Screenshot 2023-02-27 at 7 09 11 PM
    4. The research plans using interviews as the research method are populated
    5. Copy the content (texts and URLs) from Columns A-B and Columns D-H with no header from Row 2
    6. Paste the content into the "Interviews published version" tab starting from Row 3
  • If interviews are not used, leave the "Interviews published version" tab blank
  • If any of the research plans use surveys as the research method, update the "Surveys published version" tab
    1. In "All with edit links" tab, choose the filter in Research Method(s) (Column C) Screenshot 2023-02-27 at 7 08 02 PM
    2. Check "Survey" and uncheck the rest of methods Screenshot 2023-02-27 at 7 08 49 PM
    3. Choose "OK" Screenshot 2023-02-27 at 7 09 11 PM
    4. The research plans using surveys as the research method are populated
    5. Copy the content (texts and URLs) from Columns A-B and Columns D-H with no header from Row 2
    6. Paste the content into the "Surveys published version" tab starting from Row 3
  • If surveys are not used, leave the "Surveys published version" tab blank
  • If there is any other research method to be used or used, choose "[research method] published version" tab
    • Click on the green down arrow Screenshot 2023-02-27 at 3 11 35 PM and choose Rename Screenshot 2023-02-27 at 3 16 41 PM
    • Update [research method] in the name of the tab with the method to be used or used, such as "contextual inquiry", etc.
    • Update row 2 [research method] with the method to be used or used, such as "contextual inquiry", etc.
    • Populate the research plans using other research method(s) one by one
      1. In "All with edit links" tab, choose the filter in Research Method(s) (Column C) Screenshot 2023-02-27 at 7 08 02 PM
      2. Check one research method other than interview and survey, and uncheck all other methods
      3. Choose "OK" Screenshot 2023-02-27 at 7 09 11 PM
      4. The research plans using that particular research method are populated
      5. Copy the content (texts and URLs) from Columns A-B and Columns D-H with no header from Row 2
      6. Paste the content into the other research method's "published version" tab from Row 3
      7. Make one tab for each of the other research methods other than interviews and surveys if needed
  • If no other research method(s) is used, leave the "[research method] published version" tab blank
  • Update the "Published plans & goals by research methods" tab
    1. Copy the entire spreadsheet starting from Row 2 (no header) in "Interviews published version" tab if interviews are used as a research method. Otherwise, skip the "Interviews published version" spreadsheet.
    2. Paste the spreadsheet into the "Published plans & goals by research methods" tab
    3. Copy the entire spreadsheet starting from Row 2 (no header) in "Surveys published version" tab if surveys are used as a research method. Otherwise, skip the "Surveys published version" spreadsheet.
    4. Paste the spreadsheet into the "Published plans & goals by research methods" tab
    5. Copy the entire spreadsheet starting from Row 2 (no header) in "[research method] published version" tab if any other methods are used. Otherwise, skip the "[research method] published version" spreadsheet.
    6. Paste the spreadsheet into the "Published plans & goals by research methods" tab

Update Research Plan and Goals Wiki page

  • Convert the spreadsheet into Markdown language
  • Copy the spreadsheet (with header) in the "Published plans & goals by research methods" tab in Resource # 2.04
  • Open the link in Resources # 1.04
  • Paste the spreadsheet you just copied into the box with "Paste Table Here! " being displayed Screenshot 2023-02-27 at 8 04 53 PM
  • Choose "Submit" Screenshot 2023-02-27 at 8 05 47 PM
  • Use the default settings once the table is converted to Markdown. By default, "Outer pipes" and "Cell padding" are checked, and "No sorting" is the option selected on the drop down menu Screenshot 2023-02-27 at 8 09 08 PM
  • Copy the converted Markdown table from the box
  • Update Wiki page
  • Open the link in Resources # 2.03
  • Choose "Edit"
  • Paste the converted Markdown table into the text box under the ### Mentor Research Plans & Goals section
  • Remove outdated Research Plans & Goals table if there was any
  • Choose "Save page"

  • Review with UX Lead
  • Product sign-off

Resources/Instructions

Resources for creating this issue

1.01 Google Drive Folder: Research by Participant Type
1.02 Research Output Overview
1.02.01 Examples of the Research Plans and Goals Charts: Mentor Research Plans and Goals; Intern-Research-Plans-and-Goals
1.02.02 Example of the spreadsheet prior to the Github Wiki chart: Intern Research List
1.03 TWE: Template: Research Plans and Goals Chart
1.04 Convert spreadsheet to Markdown language

Resources gathered during the completion of this issue

2.01 Google Drive Folder: HfLA Volunteers
2.01.01 IP: Research Plan to find transferable skills
2.01.02 TWE: Research Plan: RP020 Intern Interaction with Hack for LA Website Team
2.02 HfLA Volunteers Research Overview
2.03 HfLA Volunteers Research Plans and Goals Chart
2.04 HfLA Volunteers Research Plans and Goals Chart Spreadsheet

@pandanista
Copy link
Member Author

pandanista commented Mar 7, 2023

At the last meeting on 2/28, I mentioned the issue was created based on a template we are still testing—meaning, while working on this issue, you might run into instructions that are not clear enough, or confusing, or direct you to a wrong folder, etc. Therefore, please leave any feedback you have below as comments as you check off the action items. Much appreciated. :)

Please see below for steps and examples for providing feedback:

Action Items for Providing Feedback on Testing Templates

  • Provide feedback for this issue
    • Add feedback in the form of (1) questions and/or (2) explicit instructions for how the content should be improved. Feedback in a Google Doc or spreadsheet should be given in the form of document comments.
    • Determine the accuracy of the content for each section (action items listed in the issue above, Google doc, or Google sheet). If you find an inaccuracy, error, or mis-categorization, explain how the information presented could be improved.
    • For each suggested improvement, provide a link, reference, or a screenshot within your comment to justify your suggestion.
      • Examples:
      Screenshot 2023-03-06 at 6 37 40 PM Screenshot 2023-03-06 at 6 37 10 PM Screenshot 2023-03-06 at 6 36 56 PM Screenshot 2023-03-06 at 6 36 46 PM
  • Once all the steps have been completed, reach out to the current UX Lead to determine if they can incorporate the feedback in the issue template.

@AndrewSalvatore

This comment was marked as outdated.

@pandanista

This comment was marked as outdated.

@AndrewSalvatore
Copy link
Contributor

AndrewSalvatore commented Apr 6, 2023

Progress: done except blockers and final couple action items

Blockers: In the Research Plans and Goals Chart excel sheet ("All with edit links" tab), what goes in the "Day" column? Also, if the interview script is in the RP doc, is it correct to just link the RP doc in column H?

Availability: 6 hours

ETA: once blockers are unblocked

Pictures or links (if necessary): none

@AndrewSalvatore
Copy link
Contributor

Progress: completed, waiting for UX lead sign-off

Blockers: none

Availability: 6 hours

ETA: done

Pictures or links (if necessary): none

@AndrewSalvatore
Copy link
Contributor

AndrewSalvatore commented Apr 13, 2023

Template Action Items to change/improve:

  • "Identify if any of the research plans are created in the folder"
  • I was confused by this wording. Perhaps change this to "Identify if there any research plans in the folder"

image

  • In reference to the image above: there needs to be a differentiation between the Research Plans and Goals chart on the Wiki and the spreadsheet used to create it. On a couple occasions, both are referred to by the same thing (the Research Plans and Goals chart). The Action Items in the above image come just after updating resource 2.03 with link for the Research Plans and Goals chart on the Wiki (i.e. you're updating it and then immediately replacing it with the spreadsheet). So the action items in this image should say something like "resource 2.04" and "the Research Plans and Goals Chart Spreadsheet". Obviously this means there should also be a 2.04 resource: "HfLA Volunteers Research Plans and Goals Chart Spreadsheet".

image

  • In reference to the image above: the markdown website no longer includes these options

@pandanista
Copy link
Member Author

Good catch. Thank you for the feedback! I have incorporated them into the template.

I would like to know why the day, and frequency need to be included. It might make more sense not to include the day and frequency due to 1). the inconsistency and lack of bandwidth based on past weekly survey not fulfilled, 2). not having to update the chart later, 3). lack of day/date information at the planning phase since the chart is provided to participants or participants' guardians during the consent phase and we might not know the exact day/date to conduct a study yet.

@AndrewSalvatore
Copy link
Contributor

Based on today's conversation at the TWE all-team meeting, we're are going to keep the Day and Frequency columns for the Plans and Goals Chart because it is used to inform volunteers, interns, and parents of expectations. For RPs that don't explicitly state the information, we'll enter TBD for them.

@pandanista
Copy link
Member Author

pandanista commented May 23, 2023

@priyatalwar I've reviewed the issue, please take a look at the deliverables.

Since we don't have the script as of now, the script URL link is not provided in the chart. We will update the script links with google form links once they are created.

@pandanista pandanista added the Ready for product When the issue is ready for product team to review label Jun 1, 2023
@pandanista pandanista changed the title TWE: HfLA Volunteer Research Plans and Goals Chart: Update TWE: HfLA Volunteer Research Plans and Goals Chart: Create Jun 15, 2023
@priyatalwar
Copy link
Member

Product reviewed it with UX Research lead

@priyatalwar priyatalwar removed the Ready for product When the issue is ready for product team to review label Jun 30, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
complexity: missing feature: overview feature: research All issues involving research p-feature: wiki Participant Type: HfLA Team member PBV: research all issues for the research team Research: RP002 Transferable Skills Research: RP020 Intern Interaction with HfLA teams role: UI/UX research size: 1pt Can be done in 6 hours
Projects
Development

No branches or pull requests

4 participants