Revised overview of DDD + new graphic.

7.0_mtl_technical_manual_facilitator.md

@@ -87,96 +87,37 @@ This section explains how to use the Facilitator Dashboard to set up and manage
 13. **CLOSE** - Click to de-select a team.
 14. **ADD TEAM** - Click to add an unlimited number of teams to the dashboard. 
 
----
 ## Sim UI Dynamic Decision Dashboard
 
-There are two ways to access the Dynamic Decision Dashboard:
-1. Make a team selection from the Select Team dropdown, then select a module and click the green Home button.
-2. Click the green Home button.
+The Dynamic Decision Dashboard answers the question  _Where is the volume across all modules?_ It shows a visual representation of where veterans accumulate and where the inflow/outflow is coming from. The primary purpose of these visuals is to help understand the dynamic system that is veteran care. This aids in comprehending how different quantities change and interact over time within a system and identifying key variables that contribute to the accumulation or depletion of stocks.
+
+To access the Dynamic Decision Dashboard from the Facilitator Dashboard, make a team selection from the Select Team dropdown, then select a module and click the green Home button. Within the Dynamic Decision Dashboard, there are five modules: Care Coordination, Medication Management, Team Flow, Team Care, and Psychotherapy. To the right of each section are icons, each with an associated dropdown menu.
 
 Below is an orientation to the Dynamic Decision Dashboard.
 
 <img src = "https://github.com/lzim/mtl/blob/gh-pages/images/ddd_initial_screen.png?raw=true">
 
-1. **Session Start** window: Select the team data file you wish to use from the dropdown menu, then press GO! _**Need to cover Learning Mode selection here?**_
-2. **Experiment** window: Description here.
-3. **Team Data** window: You can delete, upload, and add team data files here.
-4. **Dynamic Decision Dashboard** window: The Dynamic Decision Dashboard answers the question  _Where is the volume across all modules?_ It shows a visual representation of where veterans accumulate and where the inflow/outflow is coming from. The primary purpose of these visuals is to help understand the dynamic system that is veteran care. This aids in comprehending how different quantities change and interact over time within a system and identifying key variables that contribute to the accumulation or depletion of stocks.
-
-> Stocks (rectangles) are quantities measured at specific points in time, representing the accumulation of a quantity over time. They exist at a particular moment. Stocks of all modules are shown here (Care Coordination, Team Care, Medication Management, Psychotherapy, and Team Flow). The stock widget scales are standardized to support judgement of the relative size of the numbers in comparisons across all modules. Time scales are standardized to weeks.
-
-5. **Caret** toggles: Click these (located next to each module) to collapse or expand the module stocks and associated icons.
-6. **Information** icons: Click these icons to read the definition of each stock label.
-7. **Community** button: Click here to participate by sharing an idea, letting the team know what you like, asking a question, or joining our community.
-
-Within the Dynamic Decision Dashboard, there are five modules: Care Coordination, Medication Management, Team Flow, Team Care, and Psychotherapy. To the right of each section are icons, each with an associated dropdown menu. See below for dropdown menu contents and descriptions.
-
-### Directives Dropdown
-
-> James and Lindsey to work together on this. *Add image of directives here, if it's a dropdown menu.
-
-Click here to see a crosswalk table that identifies specific references within Directive 1160.01 that requires actions by facilities that are supported by the Data UI and the Sim UI. These actions are linked to _MTL_ reports and _MTL_ use cases that reinforce how the directives are supported in application by other facilities.
-
-### More Dropdown
-
-<img src = "https://github.com/lzim/mtl/blob/gh-pages/images/ddd_more_dropdown.png?raw=true">
-
-Shown with an ellipsis, this menu can include links to:
-- Feedback Loops
-- Flow
-- Decision Meters
-- Episodes of Care
-- Play
-- Team Data - Navigates to [mtl.how/data](mtl.how/data).
-- SAIL Data - Navigates to [mtl.how/sail](mtl.how/sail).
-
-### Array Dropdowns
-Shown with three stacked sheets, the array dropdown menus vary depending upon which module it is in.
-
-#### Services Array
-
-<img src = "https://github.com/lzim/mtl/blob/gh-pages/images/ddd_services_array.png?raw=true">
-
-Radio button choices are:
-- Intake
-- Care Coordination
-- Medication Management
-- Psychotherapy
-- Evidence-based Psychotherapy
-- Adjunctive Services
-- Group Therapy
-
-#### Meds Needed Array
-
-<img src = "https://github.com/lzim/mtl/blob/gh-pages/images/ddd_meds_needed_array.png?raw=true">
-
-> add image of meds needed array (ddd_meds_needed_array)
-
-Radio button choices are:
-- Alcohol Use Disorder (AUD)
-- Depression (Dep)
-- Opioid Use Disorder (OUD)
-- Other
-
-#### Setting Array
-
-<img src = "https://github.com/lzim/mtl/blob/gh-pages/images/ddd_setting_array.png?raw=true">
-
-Radio button choices are: 
-- General Mental Health (GMH)
-- Specialty Mental Health (SPC)
-- Primary Care/Primary Care Mental Health Integration (PC/PCMHI)
+1. **Tutor**: Click for a guided tour of page features.
+2. **Caret**: Click carets next to each module to contract or expand that module from view.
+3. **Directives**: Click to show a Directive 1160.01 to _MTL_ crosswalk table that identifies specific references within Directive 1160.01 that requires actions by facilities that are supported by the Data UI and the Sim UI. These actions are linked to _MTL_ reports and _MTL_ use cases that reinforce how the directives are supported in application by other facilities.
+4.  **More**: Click to reveal other key views of the module.
+5.  **Services**: This allows you to see stock values for specific services.
+6.  **Text with Red Background**: Indictes what Learning Mode the model is using to simulate.
+7.  **Meds Needed**: This allows you to see stock values for medication-specific services.
+8.  **i icon**: Click these to read the definition of each stock label.
+9.  **Setting**: This allows you to see stock values for setting-specific services.
+10. **Community**: Click here to participate by sharing an idea, letting the team know what you like, asking a question, or joining our community.
 
 ## Begin a Session in the Dynamic Decision Dashboard
 
-1. Navigate to ___.
-2. In Session Start , select the team data you want to view and click GO!
-3. Select the learning modes desired for the team data:
+1. In the Session Start pane, select the team data you want to view and click GO!
+2. Select the learning modes desired for the team data:
+
 - Existing Patient Return-to-Clinic Interval: Choose this learning mode to prioritize the Existing Patients Return-to-Clinic Visit Interval (RVI) estimated from team data, and only start new patients in remaining open slots after the existing patient RVI, appointment supply, and missed appointments are all taken into account.
 - New Patient Start Rate: Choose this learning mode to prioritize the New Patient Start Rate estimated from team data, and only see existing patients in remaining open slots after the new patient start rate, appointment supply, and missed appointments are all taken into account.
+
 4. Click Continue to initialize all models.
 
----
 
 ## Set Up a Team