Move Inclusive Research guidance to Platform

[claytonzook]

User Story

As a VFS researcher, I want all the important guidance I need in one location, that I know to be source of truth, so I don't have to hunt for it and so that I know that I'm getting the latest guidance.

As Platform Governance Team, I want make sure researchers have access to important information on Platform, since it is source of truth for research guidance.

Assignee: @CherylEvans @sterkenburgsara Peer Reviewer: @it-harrison

Description

There is some GH guidance on Inclusive Research and GH guidance on inclusive recruitment, but if this guidance is important enough for VFS researchers to reference, it's important enough to be on Platform as the source of truth.

The purpose of this ticket is to create a new page for inclusive research, publishing information that is already available on gh.

Impacted Artifacts

Inclusive Recruitment Strategies Inclusive Research Guidelines

Tasks

• [x] Decide where on Platform this information should live (@naomimarcussen can help)
• [ ] mark both GH pages as deprecated using this guidance once info is on Platform
• [ ] Incorporate any new guidance/page links into the follow pages (if necessary). Also validate any updated/revised links:
  • [ ] Platform Page on recruitment
  • [ ] Research Plan Template
• [ ] Validate that all content within guidance is up to date and accurate. For anything that is outdated:
  • [ ] if it is a simple fix, work with @naomimarcussen to make the change before publishing.
  • [ ] if the fix requires rewriting/reorganizing of the content, create a follow up ticket using the Governance team issue template and document the necessary changes. We will publish the guidance to Platform Website as-is. Work with @naomimarcussen to determine if a, "This guidance may not be up to date" warning message should be added to the Platform Website page.

Acceptance Criteria

• [ ] VFS teams are able to find guidance on inclusive research and guidance on inclusive recruitment strategies on Platform Website.
• [ ] VFS teams are redirected to the Platform Website when they encounter deprecated inclusive research pages on gh

---

How to prepare this issue

Refinement

• [x] Ticket has user story, description, tasks, and acceptance criteria
• [x] Ticket has additional appropriate labels, if applicable
• [x] Ticket has been sized
• [x] Once all above items are checked, add the 'Ready' label.

  Planning

  If this ticket is picked up from the Backlog mid-sprint, connect with Shira to ensure the below items are completed correctly

• [x] Ticket has been discussed as a team at Planning
• [x] Ticket has been assigned to appropriate initiative or quarterly epic
• [x] Ticket has been assigned to a Sprint
• [x] Ticket has been moved to the Planned pipeline in the Governance team board
• [x] Ticket as an assignee and peer reviewer

[CherylEvans]

@naomimarcussen @sterkenburgsara @it-harrison Hi Naomi! :-) I have created drafts of both of these pages. Guidance on Inclusive Recruitment and Guidance on Inclusive Research Wanted to reach out and get your input on these docs. I am definitely not a research expert by any stretch, but do see that some of the content needs reworking. I don't see anything major, simply edits that will affect readability and flow. I am going to create a new ticket to address the major changes you recommend, but wanted to get your approval to make the minor edits so it can be published quickly. The other question I had was with regard to the location of the new documents. Please let me know your thoughts, and I will work to make sure everything is completed in a timely manner, and in accordance with your guidance/input. Thanks again!

[naomimarcussen]

Thank you for working on this @CherylEvans! I'd say these pages can live in the Research: Planning and Recruiting section.

Also, feel free to add an intro and any other edits to make it flow better. These 2 pages are just a couple in a collection linked to from the Inclusive Research Guidelines in another ticket.

[CherylEvans]

@naomimarcussen You're quite welcome! :-) I was thinking I would nest them with Planning and recruiting resources, if that's okay with you. I will write short introductions to both, and once you give the thumbs up on those, I will create the pages, and hopefully they will be published by Thursday. FYSA @it-harrison @sterkenburgsara

[CherylEvans]

@naomimarcussen I removed all bad links (There is one I left that I made a note on, for your guidance.). I wrote an introduction but need your fb. DRAFT Thank you!! FYSA @sterkenburgsara @it-harrison

[CherylEvans]

@shiragoodman This ticket is on hold until Josh Kim has updated. Please refer to thread. FYSA @sterkenburgsara @briandeconinck @it-harrison

[CherylEvans]

@shiragoodman Per guidance from @naomimarcussen It was suggested we put this on pause. The documentation is very outdated and she is not she want to tell researchers how to do discovery work, let alone give them outdated information. Per Josh Kim's Slack link, he has a small task force working to update this material.

[shiragoodman]

@naomimarcussen this ticket was discussed at our refinement meeting in January 2024. Since Governance no longer has a researcher on our team, this is no longer relevant for us. I am removing the Governance label, however we may still want to make the recommended changes to the Research pages on Platform Website.