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
284 stars 206 forks source link

Update Platform documentation on Credential Service Providers (CSPs) #90108

Open claytonzook opened 3 months ago

claytonzook commented 3 months ago

Description

We recently noticed some identity related pages that are out of date

Relevant URLs

DS Logon page - https://depo-platform-documentation.scrollhelp.site/developer-docs/ds-logon
MHV page - https://depo-platform-documentation.scrollhelp.site/developer-docs/my-healthe-vet
ID.me page - https://depo-platform-documentation.scrollhelp.site/developer-docs/id-me
Login.gov page - needed!! I don't see one!
 

Which type of team are you on? (Platform team, VFS team, or Leadership)

Identity team (we're part small "p" platform and part VFS, but not on the big "P" Platform contract anymore)

taylojill commented 3 months ago

Hi @claytonzook - thanks for your content suggestions. The Platform Content team will review your request and put it in our backlog to refine for next steps.

jknipes commented 3 months ago

@claytonzook while there is not a dedicated login.gov page on Platform Website, this is one of the pages that comes up upon searching for that term. Do you feel this is sufficient?

claytonzook commented 3 months ago

@jknipes I don't think that page is the same. It looks like the one you linked is under Platform Console information and how to use that tool. The login.gov mention there seems to be only for VFS team members who need to create a personal account for work purposes.

The pages I'd mentioned for the account types (eg, credential services for veteran sign ins into VA.gov), ID.me, MHV, and DS Logon and the missing Login.gov page definitely should all be under External Integrations. They explain information like what these services are, how to integrate those services, where to see outage information, and contacts at that service.

The Login.gove integration started maybe about 2 years ago, so I'm wondering if it got missed to add a page like this for it. If that's the case or if it is missing or got deleted or something by accident, I can tag an engineer on my team if that'd be helpful for getting all the information needed for (re)building this page.

jknipes commented 3 months ago

@claytonzook I'm thinking we would want to break this up into individual tickets for each page that requires an update, and then schedule time to work with your team one page at a time. @taylojill would you agree?

jknipes commented 3 months ago

Per this Slack thread, Identity team will update the page