Merge pull request #1176 from ApolloAutomation/dev

Sync dev to main

Author: Bunton33

docs/assets/msr-1-play-buzzer-action.png

@@ -12,7 +12,7 @@ Your Apollo MSR-1 has an onboard piezo buzzer that can play short tunes. In this
 
 ![Home Assistant sidebar with the Developer tools hammer icon highlighted in orange](/assets/screenshot-2023-11-01-at-10-52-38-pm.png)
 
-2\. Click **Actions** at the top of the page. Older Home Assistant versions call this tab **Services**, as in the screenshot at the end of this guide.
+2\. Click **Actions** at the top of the page. Older Home Assistant versions call this tab **Services**.
 
 3\. Choose your MSR-1's buzzer action. Start typing `buzzer` to find it faster.
 
@@ -34,7 +34,7 @@ Find more tunes in <a href="https://picaxe.com/rtttl-ringtones-for-tune-command/
 
 5\. Click the **Perform action** button in the bottom right.
 
-![Developer tools Services tab with the MSR-1 play_buzzer service and an RTTTL song_str highlighted](/assets/screenshot-2023-11-01-at-10-57-33-pm.png)
+![Home Assistant Actions tab with the MSR-1 play_buzzer action, a Mario RTTTL tune in song_str, and the Perform action button highlighted](/assets/msr-1-play-buzzer-action.png)
 
 Your MSR-1 plays the tune.
 

docs/assets/r-pro-1-co2-calibration-press.png

@@ -20,18 +20,14 @@ This article will guide you through a simple calibration of your CO<sub>2</sub>
 
 *Shown with an AIR-1; set your R PRO-1 outdoors the same way.*
 
-2\. Go to your Home Assistant dashboard and press the letter "e". In the entity filter that pops up, type "Calibrate SCD40" and select your R PRO-1's entry (for example **Apollo R_PRO-1 353fd4 Calibrate SCD40 To 420ppm**).
+2\. Go to your Home Assistant dashboard and press the letter "e". In the entity search that pops up, type "Calibrate SCD40" and select **Calibrate SCD40 To 420ppm** under your R PRO-1. If you have several Apollo devices, add your R PRO-1's name to the search to narrow the list.
 
 !!! tip "Hint"
 
     If you cannot get this menu to pop up, click somewhere on the <a href="https://www.home-assistant.io/" target="_blank" rel="noreferrer nofollow noopener">Home Assistant</a> dashboard then press your "e" key.
 
-![Home Assistant entity search with the AIR-1 Calibrate SCD40 To 420ppm entity circled in red](/assets/co2-calibration-quick-pic-1.png)
+![Home Assistant entity search for R PRO-1 Calibrate SCD40 with the R PRO-1's Calibrate SCD40 To 420ppm button highlighted](/assets/r-pro-1-co2-calibration-search.png)
 
-*Shown for an AIR-1; your R PRO-1 lists the same Calibrate SCD40 To 420ppm button.*
+3\. Click **Press**, and you're done.
 
-3\. Click on the button that says "PRESS" and then you are done.
-
-![AIR-1 Calibrate SCD40 To 420ppm dialog with PRESS circled and an arrow to the new logbook entry](/assets/co2-calibration-quick-pic-2.png)
-
-*Shown for an AIR-1; the R PRO-1 button dialog looks the same.*
+![R PRO-1 Calibrate SCD40 To 420ppm dialog with the Press button highlighted](/assets/r-pro-1-co2-calibration-press.png)

docs/assets/r-pro-1-co2-calibration-search.png

@@ -32,7 +32,7 @@ Next, create the automation that sends the notification to your phone.
 
 5\. Click **Add trigger → Entity → Numeric state** and search for your TEMP-1 temperature probe, such as "temp-1 temperature probe". In the box labeled **Above**, type the maximum temperature you decided on in step 2. Prefer YAML? Skip ahead to the [freezer automation YAML](#freezer-automation-yaml).
 
-![Home Assistant numeric state trigger on TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png)
+![Home Assistant numeric state trigger on the TEMP-1 Temperature Probe, with the entity and the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png)
 
 6\. Click **Add action**, type "iPhone", and select your phone. If you don't see your phone, or you have an Android phone, type "notify" instead and scroll down until you find your phone in the list.
 
@@ -97,7 +97,7 @@ This example walks you through setting up an automation in Home Assistant with t
 
 4\. Click **Add trigger → Entity → Numeric state** and search for your TEMP-1 food probe, such as "temp-1 food probe". In the box labeled **Above**, type the temperature you want for your food. This example uses 165°F (73.9°C), the temperature it's safe to cook chicken to. Prefer YAML? Skip ahead to the [food probe automation YAML](#food-probe-automation-yaml).
 
-![Home Assistant numeric state trigger with the TEMP-1 Max Probe Temp entity and Above 165 fields highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png)
+![Home Assistant numeric state trigger on the TEMP-1 Food Probe, with the entity and the Above field set to 165 highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png)
 
 5\. Click **Add action**, type "iPhone", and select your phone. If you don't see your phone, or you have an Android phone, type "notify" instead and scroll down until you find your phone in the list.
 
@@ -203,9 +203,9 @@ Option 1 runs when you turn Chicken Monitor on. It turns the LED green and tells
 
 ![Home Assistant Add condition dialog with trigger id searched and Triggered by listed](/assets/temp-1-cook-chicken-example-pic-13.png)
 
-11\. Check **Chicken Monitor On**, the trigger ID you created in step 5.
+11\. Check **State changed to on**, the first trigger in the list. It's the trigger you gave the Chicken Monitor On ID in step 5.
 
-![Home Assistant Choose action Option 1 with the trigger ID checkbox highlighted](/assets/temp-1-cook-chicken-example-pic-14.png)
+![Home Assistant Triggered by condition with the first trigger, State changed to on, checked and highlighted](/assets/temp-1-cook-chicken-example-pic-14.png)
 
 12\. Still under Option 1 in the Choose action, click **Add action**, search "light", and select **Light: Turn on**.
 

docs/assets/temp-1-cook-chicken-example-pic-14.png

@@ -44,7 +44,7 @@ With your thresholds set, the automation is now ready to be created.
 
 5\. Click **Add Trigger**, then **Entity**, then **Numeric state**, and search for your TEMP-1B temperature probe, such as "temp-1b temperature probe". In the box labeled **Above**, type the maximum temperature you picked in step 2. Enter the value in the unit your Home Assistant shows (°F in this example). Advanced users can skip to the YAML at the end of this section.
 
-![Home Assistant numeric state trigger on TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png)
+![Home Assistant numeric state trigger on the TEMP-1 Temperature Probe, with the entity and the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png)
 
 *Shown on a TEMP-1; pick your TEMP-1B entity instead.*
 
@@ -114,7 +114,7 @@ Set up a Home Assistant automation that uses the food probe while you cook chick
 
 4\. Click **Add Trigger**, then **Entity**, then **Numeric state**, and search for your TEMP-1B device, such as "temp-1b food probe". In the box labeled **Above**, type the temperature you want for your food. This example uses 165°F (73.9°C), the temperature it's safe to cook chicken to. Enter the value in the unit your Home Assistant shows (°F in this example). Advanced users can skip to the YAML at the end of this section.
 
-![Home Assistant numeric state trigger with the TEMP-1 Max Probe Temp entity and Above 165 fields highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png)
+![Home Assistant numeric state trigger on the TEMP-1 Food Probe, with the entity and the Above field set to 165 highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png)
 
 *Shown on a TEMP-1; pick your TEMP-1B entity instead.*
 
@@ -221,11 +221,9 @@ Now add the **Choose** action. Option 1 runs when you turn Chicken Monitor on.
 
 ![Home Assistant Add condition dialog with trigger id searched and Triggered by listed](/assets/temp-1-cook-chicken-example-pic-13.png)
 
-11\. Check **Chicken Monitor On**, the trigger ID you created in step 5.
+11\. Check **State changed to on**, the first trigger in the list. It's the trigger you gave the Chicken Monitor On ID in step 5.
 
-![Home Assistant Choose action Option 1 with the Button Pressed trigger checked and highlighted](/assets/temp-1-cook-chicken-example-pic-14.png)
-
-*The screenshot shows a trigger ID called Button Pressed. In your automation, check Chicken Monitor On.*
+![Home Assistant Triggered by condition with the first trigger, State changed to on, checked and highlighted](/assets/temp-1-cook-chicken-example-pic-14.png)
 
 12\. While still under **Option 1** in the Choose action, click **Add Action**, search "light", and select **Light: Turn on**.