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

Revise navigation for Research and Design based on results of tree test #45107

Closed chaseakirby closed 2 years ago

chaseakirby commented 2 years ago

User Story

As a researcher, designer, or team stakeholder on the VA Platform, I want to easily find resources that may affect my team's research and design practices on VA Platform.

Assignee: @jimuhh Peer Reviewer: @CherylEvans

Description

Ticket #44196 was to perform quick research asking 5-7 questions regarding findability on Platform Website for Research and Design. This ticket is to implement the findings.

Impacted Artifacts

Research and Design Page on Platform

Tasks

Peer Review

Acceptance Criteria

How to prepare this issue

jimuhh commented 2 years ago

Discussed next steps for revised nav w/ @naomimarcussen and @claytonzook. Will revise schema based on our shared understanding.

shiragoodman commented 2 years ago

@naomimarcussen We had Clayton listed as a reviewer for this ticket (in addition to Cheryl). Once complete, would you be able to take a look and make sure it's implemented as expected? Please and thank you!

naomimarcussen commented 2 years ago

I'm happy to review. If you need any help doing the work, I'm happy to help with that as well.

jimuhh commented 2 years ago

Hi @naomimarcussen. I've submitted the new schema to Platform Confluence Not having Clayton around to draft some of the new top-level pages throws a bit of a monkey wrench into things= but I did my best to adapt.

jimuhh commented 2 years ago

@naomimarcussen See schema below...

Research: Overview  
    Research Overview
Research: Planning and recruiting   
    Planning and recruiting
    Planning and recruiting checklist
    Planning Moderated studies
    Planning Unmoderated studies
    Recruting participants
Research: Conducting sessions   
    Conducting Research Sessions
    Conducting sessions checklist
    Pilot participant guidelines
    Observer Guidelines
    Safety and Emergency Exit
    Tech set-up checklist
    Recording research sessions
Research: Mobile sessions   
    iPhone: Start screen share
    iPhone: Stop screen share
    iPhone: Screen recording set-up
    iPhone: Access chat
    Android: Start screen share
    Android: Stop screen share
    Android: Share device audio
Research: Assistive technology sessions 
    Research with Assistive Technology Users
    Testing with screen readers
    Disability Etiquette

As you can see, it doesn't have some of the content changes we discussed because Clayton isn't around to make the planned pages and the rest of planned content isn't available right now

jimuhh commented 2 years ago

But I've submitted the schema to Vicki at Platform Confluence

naomimarcussen commented 2 years ago

@jimuhh Thank you for this! I'll work on organizing our content according to this schema in the Platform website drafts space in Confluence. As for the new pages, I'll give it a go but I would love some help from the Platform content team.

shiragoodman commented 2 years ago

change announcement has been posted to #vfs-change-announcements and then cross shared in #vfs-all-teams, #design and #research-ops.

@jimuhh please verify the remaining tasks. @CherylEvans please peer review and follow up here if any tasks and/or activities still need to be verified or completed.

jimuhh commented 2 years ago

@naomimarcussen -- It looks like most of the "to-dos" on this spreadsheet are accounted for. The only remaining ones were going to be adding a page specifically about surveys, w/ focus on PRA and privacy concerns. Clayton was going to do that. I can ask in VA research channel and have a go on stubbing one out.

CherylEvans commented 2 years ago

@shiragoodman @jimuhh Given your comment Jim, is this ready for peer review? If you don't mind, will you provide a link for all your drafts that I need to review? Also, I am a little confused. Have these changes already been made to the Platform Website? I see that the announcement was made, and that is why I am confused. Please advise. I have also requested access to the Google sheets referenced above. Sorry for all of the questions, I simply want to perform an accurate and complete review.

jimuhh commented 2 years ago

@CherylEvans Sorry if I didn't clarify. The remaining tasks here would be covered by the tech debt tickets I'll be creating. And yes, the changes have.been made to platform website.

jimuhh commented 2 years ago

@CherylEvans So yeah, I don't know how much peer review is left to complete.

CherylEvans commented 2 years ago

@jimuhh It's all good! Thank you for sharing the doc with me. In as much as I understand what was to be accomplished with this ticket, I think everything looks good. There were a lot of moving parts with this ticket for sure. :-)

naomimarcussen commented 2 years ago

@jimuhh That would be great for you to take a stab at a page specific to surveys! I imagine it'll be similar (in regards to the PRA content) to the Planning Unmoderated Studies.

jimuhh commented 2 years ago

@naomimarcussen, @shiragoodman I am going to check off the remaining tasks and create a backlog ticket for the surveys page.