Observability: Model page (#3743)

Co-authored-by: Trey Spiller <1831878+treysp@users.noreply.github.com>

Author: mesmith027

docs/cloud/features/observability/model.md

@@ -1,37 +1,62 @@
 # Models
 
-From the main environments list, you can access individual models to explore their comprehensive observability features and detailed summary information. This centralized view provides quick access to critical model metrics and performance data.
+The model overview page provides comprehensive observability features that let you explore detailed information about a model. This centralized view gives you quick access to critical metrics and performance data, providing a window into the model's health and status.
 
-Click the environment you want to explore from the environments list
+Model owners typically use this page to monitor and check their models. It provides essential information in an easy-to-scan format, eliminating the need to debug issues through the command line interface. From this page you can quickly diagnose:
 
-![Tobiko Cloud environment page](./model/tcloud_environments.png)
+1. Model anomalies
+    1. Did the model suddenly take a really long time to run? 
+    2. Is the model repeatedly failing due to audits or schema evolution? 
+2. Downstream impacts 
+    1. If the model fails to run, lineage lets you immediately see what other models are affected 
+3. Which version introduced errors
+    1. Use the model's version history to identify which changes caused a problem
 
-Navigate to the Models section and click "Explore" to view available models
 
-![Tobiko Cloud environment page explore models link](./model/tcloud_environment_explore-models.png)
+## Navigate to a model
 
-Browse through the model list and select your desired model to access its detailed information
+There are a number of ways you can navigate to a model's page. This method shows you how to find your model directly from the Environments page. 
 
-![Tobiko Cloud environment models list](./model/tcloud_model_list.png)
+1. Select "Environments" from the left hand menu
+2. Click the environment you want to explore from the list. 
+    ![Tobiko Cloud environment page](./model/tcloud_environments.png)
+3. Navigate to the Models section and click "Explore" to view available models
+    ![Tobiko Cloud environment page explore models link](./model/tcloud_environment_explore-models.png)
+4. Browse through the model list and select a model to access its detailed information
+    ![Tobiko Cloud environment models list](./model/tcloud_model_list.png)
 
-Each model presents a comprehensive summary overview that includes several key components and metrics for monitoring and analysis.
+## Model page information
+
+Each model page presents a comprehensive summary that includes the key components and metrics used to monitor model behavior. 
+
+From here, you can identify anomalies in the model's run time based on historical run times and how they have been changing over time (or not!).
+
+You can also check other critical information, like the model's source code, its lineage relative to other models, its contents in previous versions, and even an approximation of how much it costs (if you have [cost savings set up](../costs_savings.md)).
 
 The following detailed information outlines the different sections:
 
 ![Tobiko Cloud model status and metadata](./model/tcloud_model_status-metadata.png)
 
-- Current status: Provides visual representations of model health through freshness indicators and detailed daily execution graphs
-
-- Model details: Features comprehensive tabs that display summary statistics, complete source code documentation, and interactive model lineage visualizations
+- Current status graphs: Provide visual representations of model health through freshness indicators and detailed daily execution graphs
+    - Freshness indicator: Shows the current status of the model and the percentage of up-to-date models in production (as long as this is green, you have nothing to worry about in your production environment)
+    - Historical Freshness graph: Gives an at-a-glance picture of the history of the model's freshness.
+        - Green means it's up to date and has run smoothly for every interval
+        - Orange means that one interval is pending and will be processed on the next run
+        - Red means the model has more than one interval waiting to be processed because an interval was not processed during a previous run
+    - Daily executions: tells you the length of time it took the model to run on each day. This is a great place to quickly identify anomalies in the model's run time (both running too long *or* too short).
+- Model details: Features tabs that display summary statistics, model source code, and interactive model lineage visualizations
 
 ![Tobiko Cloud model version history](./model/tcloud_model_2.png)
 
 - Version history: Delivers a comprehensive chronological view of all model versions, with detailed information including:
     - Precise timestamp of version promotion
     - Clear indication of change impact (breaking or non-breaking modifications)
     - Direct access to the complete implementation plan code
-- Loaded intervals: these periods represent the time spans between consecutive cron job executions, from the start of one cron job to the end of the next cron job. These intervals are crucial for understanding the boundaries of data processing cycles
-    - the table displays which specific model version was responsible for generating and processing data during each distinct cron interval, enabling precise tracking of version-specific outputs
-    - helps track forward-only model changes by maintaining a clear chronological record of modifications, ensuring data consistency and preventing retroactive alterations
-    - provides comprehensive visibility into completed data processing operations, allowing users to monitor progress and verify successful execution of scheduled tasks
+- Data Warehouse costs: estimates the cost of the model as set up by your team in [cost savings](../costs_savings.md)
+
+![Tobiko Cloud model version history](./model/tcloud_model_3.png)
+
+- Loaded intervals: these periods represent the time spans processed during each job execution, which generally consist of the time between one job and the next. These intervals are crucial for understanding the boundaries of data processing cycles, which may correspond to the start of anomalous model behavior.
+    - The table displays the specific model version in effect during that job execution, enabling precise tracking of version-specific outputs
+    - Helps track forward-only model changes by maintaining a clear chronological record of modifications, ensuring data consistency and preventing retroactive alterations
 - Recent activity: Maintains a detailed log of version executions and comprehensive version audits