Add Plain Language to Most Common KB Articles

[gracekretschmer-metrostar]

User Story or Problem Statement

As a CMS editor, I need to be able to understand the KB articles without having to navigate complex engineering jargon.

As a CMS editor, I need to see that my feedback from the editor survey was used to inform future development of the CMS.

Description or Additional Context

Follow the plain language guide on VA.gov. Grab the most popular articles found in GA of the Knowledge Base.

Top 10 most trafficked Knowledge Base Articles

• PDF attached houses data for the following list of pages editors visited between 11/4/24 and 12/3/24

1. • https://prod.cms.va.gov/help/get-training
2. • https://prod.cms.va.gov/help/vet-centers/vet-center-content-review
3. • https://prod.cms.va.gov/help/vamc/how-to-add-edit-or-remove-a-vamc-facility-health-service
4. • https://prod.cms.va.gov/help/vamc/how-do-i-update-my-vamc-facilitys-basic-location-data
5. • https://prod.cms.va.gov/help/va-directive-6102
6. • https://prod.cms.va.gov/help/cms-basics
7. • https://prod.cms.va.gov/help/cms-basics/how-to-request-a-cms-account
8. • https://prod.cms.va.gov/help/get-training/session-1-getting-started
9. • https://prod.cms.va.gov/help/veterans-benefits-administration-vba
10. • https://prod.cms.va.gov/help/get-training/session-3-services

Steps for Implementation

• Partner with Marisa and Grace to identified the most commonly clicked KB articles.
• @srancour use the VA.gov plain language guide to update the articles to be in alignment with the guide.
• @ian-sears and/or @TroyCMSSupport review Steve's edits to confirm they are understandable for an editor.

Acceptance Criteria

• The top trafficked articles on the Knowledge Base are in alignment with the VA.gov plain language guide.

[MDomngz]

@srancour got the list added for the most visited pages. The PDF houses the data for the list that breaks down a few metrics. The one page I was hoping to get your review of is the following: https://prod.cms.va.gov/help/vamc/how-to-add-edit-or-remove-a-vamc-facility-health-service
If you could, please indicate that this specific article is good to go in terms of readability and procedural accuracy. Thank you!
report (1).pdf

[srancour]

The one page I was hoping to get your review of is the following: https://prod.cms.va.gov/help/vamc/how-to-add-edit-or-remove-a-vamc-facility-health-service If you could, please indicate that this specific article is good to go in terms of readability and procedural accuracy. Thank you!

This article isn't terrible, but there are a couple of issues I wrote down and will fix.

[srancour]

Updated the How to add, edit, or remove a VAMC facility health service article. @ian-sears and @TroyCMSSupport feel free to review to make sure it's good.

[srancour]

Get training article has been updated. @ian-sears and @TroyCMSSupport feel free to review to make sure it's good.

[TroyCMSSupport]

@srancour - KBA number 1 (https://prod.cms.va.gov/help/get-training) looks good!

[TroyCMSSupport]

@ian-sears @srancour - KBA number 3 (https://prod.cms.va.gov/help/vamc/how-to-add-edit-or-remove-a-vamc-facility-health-service) - Nicely done! Nice screen caps!

[TroyCMSSupport]

@ian-sears @srancour - KBA number 5 https://prod.cms.va.gov/help/va-directive-6102 - Looks good.

[srancour]

@gracekretschmer-metrostar Updated the list of pages to be a checklist to capture when completed.