2024_08 #story_b: MTL 3.7 Consult Manual QA/QC content checks

ljmoody commented 7 months ago

FYI: Manual CONTENT is being tracked in #3168

Leanest guide/manual updates we could do:

[x] Find & replace MTL 3.7 "facilitator" to "consultant"
[x] Remove any reference in 3.7 to "12 session plan"
[x] Keep Red/Blue (continues until the NIH & VA trials wrap in 2024)

Updates, changes, & checks:

[x] Link to CPT Cheatsheet --> and check that MM and Psych Epi of Care "i" icons link to this correctly
[ ] Update all Tutor manual links to 1) open a new browser window to 2) corresponding location of content in MTL Manual (via Tutor Administrative Dashboard)
[ ] ~Check for linked graphics that begin with "!" and replace with graphics (may need to recreate or move to gh-pages->images folder)~
[x] Change "Facilitator Dashboard" heading to "Administrator Dashboard" (Decision made 2/28/24 in sim_ui_workflow)
[x] 1st page of manual: "Modeling to Learn 3.7 Consult Manual"
[x] Direct link to manual will be: https://mtl.how/manual
[ ] Remove the old 12 session plan and reflect the current process:
systems_sme
- [ ] Prep consult.
- [ ] Schedule consult with site and #ilead_workflow for CME/CEUs

Find & Replace:

[x] facilitator->consultant
[x] facilitate->consult
[x] administrator->user
[x] MTL->MTL
[x] team time->site study
[x] team time (tt) report, tt3, tt 3->MTL Report
[x] Facilitator Dashboard->Administrator Dashboard

ljmoody commented 7 months ago

@tejaspesquare - please change the name of this dashboard as shown in the screenshot:

fyi: @lijenn, @lzim

lzim commented 6 months ago

wk4 2024_mar_epic

The outline for the MTL 3.7 Consult Manual needs to be finalized in wk1 2024_apr_epic @lzim is working on this to discuss at the #support_workflow 3rd hour of #consult_workflow prep Tues 04/02 at 10AM Pacific

ljmoody commented 4 months ago

Hi @lzim, how is the order of information for the consult manual coming along? Do you need any help Jenn or I can provide? I plan on joining the last hour of wk3 May #systems_sme_workflow tomorrow, so it's possible we can touch on this there.

fyi @lijenn

lzim commented 4 months ago

wk3 2024_06 @ljmoody @lzim @lijenn

Assets Required/Developed

[ ] Thumbnails > Team PSD repo > resources > mtl_consult_thumbnails
[ ] MTL Use Case Videos: Why & How of Modeling to Learn Consults in #ilead_workflow
[ ] **Bookdown MTL 3.7 Consult

Chapter 1 Why use Modeling to Learn

Chapter 2 How to use Modeling to Learn

Chapter 3 Technical Documentation

[ ] 03.01 MTL 3.7 Red - This is for internal Veterans Health Administration staff.
[ ] 03.02 MTL 3.7 Blue - This is for internal Veterans Health Administration consults.
[ ] 03.03 MTL 3.7 Demo - This is for the public.

Functional Requirements - Public-facing manual (not a lot of internal links on GitHub; link to within VA via Teams)

[ ] 1. Create a README.md that links to the videos using the Thumbnails and links to the MTL 3.7 Consult Manual
[ ] 2. Create the Markdown text of the Chap 1 & Chap 2 content from the associated videos
[ ] 3. Copied text #Approved #ilead_workflows

1. Why place a Modeling to Learn 3.7 Consult? (10 chapters/videos)

[ ] 01. How might Modeling to Learn help?
[ ] 04. How can a Modeling to Learn consult help?
[ ] 02. What gets in the way of meeting patients' needs?
[ ] 21. If we keep making the same care decisions, will things get better or worse?
[ ] 05. Why is Modeling to Learn useful when we have critical staffing and hiring needs?
[ ] 13. Why is the MTL Red Data User Interface useful?
[ ] 15. Why is the MTL Blue Simulation User Interface useful?
[ ] 16. Why is applied systems thinking more likely to help us avoid costly mistakes?
[ ] 17. Why is Modeling to Learn able to provide new insights?
[ ] 18. Why does Modeling to Learn emphasize flows through care over time?

2. How can Modeling to Learn help?

[ ] 03. How can we get more patients better without more hours in the day?
[ ] 06. How does Modeling to Learn benefit Substance Use Disorder or SUD programs?
[ ] 07. How does Modeling to Learn benefit PTSD Clinical Teams or PCTs?
[ ] 08. How does Modeling to Learn benefit Behavioral Health Integration Program or BHIP teams?
[ ] 09. How does Modeling to Learn support stepped care?
[ ] *10. How does measurement based care detect patient improvement or risk?
[ ] 12. How can we improve SAIL with Modeling to Learn?
[ ] 14. How do five key variables drive care quality?
[ ] 19. How does Modeling to Learn help improve medication management?
[ ] 20. How does Modeling to Learn help improve psychotherapy?
[ ] 22. How does our appointment backlog extend the weeks between visits?
[ ] 23. How can we better balance needs of new and existing patients?
[ ] 24. How can we leverage the feedback, rates, and volume of our local care system?
[ ] 11. What key drivers of higher care quality improve recovery and prevent suicide?

lijenn commented 2 months ago

Discussed 7/19 Team Praxis Call:

[ ] @jamesmrollins dispositioned this to wk5 when @ljmoody is back.
[ ] @ljmoody to assign estimates.
[ ] @matomasz can help with merge conflicts

ljmoody commented 1 month ago

8/1/2024 update:

[x] plan to do leanest updates as mentioned in this card - COB tomorrow
[x] will perform find-&-replace on each chapter of new manual - estimate by COB tomorrow
[ ] will work with @matthewtomo re: merge conflicts, consolidating updated information, & review before publishing
[x] further tasks that will need cards created to track/do later and when able include:
- [x] Update all Tutor manual links to 1) open a new browser window to 2) corresponding location of content in MTL Manual (via Tutor Administrative Dashboard)
- [x] Check for linked graphics that begin with "!" and replace with graphics (may need to recreate or move to gh-pages->images folder); #3231 is for fixing broken image links in Team PSD and MTL Manuals

fyi: @jamesmrollins @lijenn @matthewtomo

ljmoody commented 1 month ago

Breaking remaining tasks in this card down into manageable chunks and closing this card with points revised reflect work effort.

Created #3245 to track tutor links to manual (open in new window at corresponding location of content within manual)
Tracking possible development of systems_sme current process in #3243

lzim / teampsd