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 204 forks source link

Finalize new Collab Cycle flow design and publish to Platform Website #94634

Closed shiragoodman closed 1 week ago

shiragoodman commented 3 weeks ago

User Story

As a Governance team member supporting the Collab Cycle, I want to finalize the new simplified visual of the full Collab Cycle so that I can publish it to Platform Website for VFS team use.

Assignee: @allison0034 Peer Reviewer: @erinrwhite

Description

In ticket #93198, Governance team proposed a new design demonstrating the overall flow of the Collaboration Cycle. This design is intended to replace the current swimlane diagram because the swimlane diagram 1) has become too complicated and cluttered due to the addition of several new touchpoints in 2024 (CMS Request, PO Sync and Architecture Intent), and 2) due to the size of the diagram, it's not able to be published as an image on Platform Website and is only accessible from a link, meaning it's not as visible to VFS teams as we'd like it to be.

In this ticket, we will finalize the design for the new, simplified visual (version 4) , and publish the image as an image file, no longer as a Mural. Then, the new visual will be published to the Collaboration Cycle Overview page and the link to the swimlane Mural will be removed. Due to this change, we will need to reevaluate the existing content and potentially make changes.

We will ensure that the new image and new content meets our own standards for design, accessibility, content and IA.

Impacted Artifacts

Live pages

Drafted pages

Tasks

Peer Review

To be completed by peer reviewer

Acceptance Criteria

Team Notification

How to prepare this issue

Refinement

allison0034 commented 3 weeks ago

Asking CMS team about come timing content.

allison0034 commented 3 weeks ago

@KKitagawa-Bosch can you please take a look at the content on the Mural?

allison0034 commented 3 weeks ago

Created draft

KKitagawa-Bosch commented 3 weeks ago

@allison0034 Made some comments in the mural!

allison0034 commented 2 weeks ago

@KKitagawa-Bosch I made most of your content changes. Everything is now in the actual draft in the draft section of this GH ticket. Want to take another look? For context, all the info was pulled from PW collab cycle.

@briandeconinck can you please help with alt text?

KKitagawa-Bosch commented 2 weeks ago

@allison0034 looks good overall! Made one more comment and also bumping that the "general comment" about periods on the right side is still there. Very small stuff, both of them

allison0034 commented 2 weeks ago

@KKitagawa-Bosch I don't see any comments in the draft page??? Am I missing them? ; )

KKitagawa-Bosch commented 2 weeks ago

Oh! Sorry I was commenting in the mural still. Post-SR brain :P

I'll go look at the draft page!

allison0034 commented 2 weeks ago

@shiragoodman take a look at the draft page when you get a chance, I had to adjust the layout of the text for accessibility (heading structure and font size) reasons.

erinrwhite commented 2 weeks ago

@allison0034 I added some comments too - thanks for the lift on this!

KKitagawa-Bosch commented 2 weeks ago

@allison0034 left one baby comment (literally one missing period) otherwise looks solid!

shiragoodman commented 2 weeks ago

@allison0034 I reviewed, and it looks good. the only concern I have is when to schedule CMS Request. please review my comment Allison, and reach out to CMS team for clarification. Please tag the thread here. ty!

shiragoodman commented 2 weeks ago

@allison0034 per our conversation via Slack, please move forward with the work with the CMS Request content as-is. I will reach out to Grace and we can discuss how to proceed. If we make any changes, it will be handled in another ticket. Thank you!

allison0034 commented 2 weeks ago

@briandeconinck I added engineering to the list, also I need the alt text. @erinrwhite you can review everything except alt text : )

briandeconinck commented 2 weeks ago

@allison0034 Added alt text. Whew!

allison0034 commented 2 weeks ago

@erinrwhite we are good to review. : )

erinrwhite commented 2 weeks ago

Looks good @allison0034 just don't forget to update the last updated date when you push to live!

allison0034 commented 2 weeks ago

@erinrwhite thank you!