department-of-veterans-affairs / va.gov-team

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
283 stars 203 forks source link

Move Inclusive Research guidance to Platform #41709

Open claytonzook opened 2 years ago

claytonzook commented 2 years ago

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

Acceptance Criteria


How to prepare this issue

Refinement

CherylEvans commented 2 years ago

@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 commented 2 years ago

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 commented 2 years ago

@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 commented 2 years ago

@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 commented 2 years ago

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

CherylEvans commented 2 years ago

@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 commented 8 months ago

@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.