Add shopping item removal service (home-assistant#25109)

spacegaier · web-flow · commit 2b5228d2555a · 2022-12-02T12:41:22.000+01:00
diff --git a/source/_integrations/shopping_list.markdown b/source/_integrations/shopping_list.markdown
@@ -23,35 +23,43 @@ You can add or remove items from your shopping list by using the following servi
 
 ### Service `shopping_list.add_item`
 
-Adds an item to the shopping list.
+Add an item to the shopping list.
 
 | Service data attribute | Optional | Description                                            |
 |------------------------|----------|--------------------------------------------------------|
 | `name`                 |       no | Name of the item to add. Example: "Milk"               |
 
+### Service `shopping_list.remove_item`
+
+Remove the first item with matching name from the shopping list.
+
+| Service data attribute | Optional | Description                                            |
+|------------------------|----------|--------------------------------------------------------|
+| `name`                 |       no | Name of the item to remove. Example: "Milk"            |
+
 ### Service `shopping_list.complete_item`
 
-Marks an item as completed in the shopping list. It does not remove the item.
+Mark the first item with matching name as completed in the shopping list. It does not remove the item.
 
 | Service data attribute | Optional | Description                                            |
 |------------------------|----------|--------------------------------------------------------|
 | `name`                 |       no | Name of the item to mark as completed. Example: "Milk" |
 
 ### Service `shopping_list.incomplete_item`
 
-Marks an item as incomplete in the shopping list.
+Mark the first item with matching name as incomplete in the shopping list.
 
 | Service data attribute | Optional | Description                                            |
 |------------------------|----------|--------------------------------------------------------|
 | `name`                 |       no | Name of the item to mark as incomplete. Example: "Milk" |
 
 ### Service `shopping_list.complete_all`
 
-Marks all items as completed in the shopping list. It does not remove the items.
+Mark all items as completed in the shopping list (without removing them from the list).
 
 ### Service `shopping_list.incomplete_all`
 
-Marks all items as incomplete in the shopping list.
+Mark all items as incomplete in the shopping list.
 
 ### Service `shopping_list.clear_completed_items`
 
