Skip to content

Commit 15ee451

Browse files
authored
Improve Twente Milieu documentation (#38838)
1 parent 80c068c commit 15ee451

File tree

1 file changed

+32
-45
lines changed

1 file changed

+32
-45
lines changed

source/_integrations/twentemilieu.markdown

+32-45
Original file line numberDiff line numberDiff line change
@@ -19,70 +19,57 @@ ha_integration_type: service
1919
ha_quality_scale: silver
2020
---
2121

22-
The Twente Milieu {% term integration %} enables you to monitor the upcoming
23-
waste collection schedules provided by
24-
[Twente Milieu](https://www.twentemilieu.nl/) for various waste categories.
25-
This integration helps you stay informed about the next pickup dates for
26-
different types of waste, ensuring you never miss a collection day.
22+
The **Twente Milieu** {% term integration %} enables you to monitor the upcoming waste collection schedules provided by [Twente Milieu](https://www.twentemilieu.nl/), a waste collection company serving municipalities in the Twente region of the Netherlands, including Enschede, Hengelo, Almelo, Borne, Hof van Twente, Oldenzaal, and Losser. This integration helps you stay informed about the next pickup dates for different types of waste (like organic, paper, plastic, and non-recyclable), ensuring you never miss a collection day.
2723

2824
{% include integrations/config_flow.md %}
2925

30-
### Configuration parameters
31-
3226
{% configuration_basic %}
3327
Postal code:
3428
description: The postal code of the address, for example "7500AA".
3529
House number:
3630
description: The house number of the address.
3731
House letter/additional:
38-
description: The house letter or additional information of the address.
32+
description: The house letter or additional information of the address, if applicable.
3933
{% endconfiguration_basic %}
4034

4135
## Use cases
4236

43-
The integration provides sensors for the next waste pickup dates. You can use
44-
this information to create automations, for example, to remind you to put out
45-
the waste bins the night before the pickup.
37+
With the Twente Milieu integration, you can:
4638

47-
Besides the sensors, the integration also provides a calendar to Home Assistant.
48-
Meaning you can view all upcoming waste pickups in the calendar dashboard.
39+
- Monitor upcoming waste collection dates for different waste types
40+
- Create automations to remind you to put out your waste bins before collection day
41+
- View all your upcoming waste pickups in the calendar dashboard
42+
- See at a glance when your next waste collection is due
4943

5044
## Supported functionality
5145

5246
### Calendar
5347

54-
The integration provides a calendar to Home Assistant. You can view
55-
all upcoming waste pickups in the calender dashboard.
48+
The integration provides a calendar entity that displays all upcoming waste collection dates from Twente Milieu. You can view this calendar in your {% my calendar title="Calendar dashboard" %}.
5649

5750
### Sensors
5851

59-
This integration provides sensors for the following waste pickup dates from
60-
Twente Milieu:
61-
62-
- Next plastic waste pickup date.
63-
- Next organic waste pickup date.
64-
- Next paper waste pickup date.
65-
- Next non-recyclable waste pickup date.
66-
- Next Christmas Tree pickup date.
52+
This integration creates the following sensors for upcoming waste collection dates:
6753

68-
## Data updates
54+
- Next plastic waste pickup date
55+
- Next organic waste pickup date
56+
- Next paper waste pickup date
57+
- Next non-recyclable waste pickup date
58+
- Next Christmas tree pickup date (seasonal)
6959

70-
The integration will update its information by polling Twente Milieu every
71-
hour. This ensures the data in Home Assistant is up to date.
60+
Each sensor provides the next scheduled date for its respective waste type, allowing you to track when to put out specific bins.
7261

73-
## Actions
62+
## Data updates
7463

75-
This integration does not provide additional actions.
64+
The integration updates its information by {% term polling %} the Twente Milieu service every hour. This ensures your waste collection schedule in Home Assistant stays current.
7665

7766
## Examples
7867

79-
The following examples show how to use the Twente Milieu integration in Home
80-
Assistant automations.
68+
Below are practical examples of how you can use the Twente Milieu integration in your automations.
8169

8270
### Send notification the evening before the garbage pickup day
8371

84-
The following example sends a notification to your mobile device the evening
85-
before the garbage pickup day. This ensures your bins are out on time.
72+
This example sends a notification to your mobile device the evening before collection day, ensuring you remember to put out the correct bin.
8673

8774
```yaml
8875
automation:
@@ -92,50 +79,50 @@ automation:
9279
event: start
9380
entity_id: calendar.twente_milieu
9481
offset: "-6:00:00"
82+
# This triggers 6 hours before the calendar event starts
9583

9684
actions:
9785
- action: notify.mobile_app_your_device
9886
data:
9987
title: "Garbage day!"
100-
message: >
88+
message: >
10189
Reminder: Tomorrow is {{ trigger.calendar_event.summary }} pickup
10290
day. Don't forget to put out the bin!
10391
```
10492
105-
### Send notification at the end of day to haul in the empty bin again
93+
### Send notification at the end of day to bring in the empty bin
10694
107-
The following example sends a notification to your mobile device at the end of
108-
the day to remind you to haul in the empty bin again.
95+
This example sends a notification to remind you to bring the empty bin back in after collection.
10996
11097
```yaml
11198
automation:
112-
- alias: "Reminder to haul in the bin"
99+
- alias: "Reminder to bring in the bin"
113100
triggers:
114101
- trigger: calendar
115-
event: end
102+
event: end
116103
entity_id: calendar.twente_milieu
117104
offset: "-4:00:00"
105+
# This triggers 4 hours before the calendar event ends
118106

119107
actions:
120108
- action: notify.mobile_app_your_device
121109
data:
122-
title: "Haul in the bin!"
123-
message: >
124-
Reminder Garbage has been picked up today. Don't forget to haul in
125-
the bin!
110+
title: "Bring in the bin!"
111+
message: >
112+
Reminder: The waste has been collected today. Don't forget to
113+
bring in your empty bin!
126114
```
127115
128116
## Known limitations
129117
130-
There are no known limitations for this integration.
118+
- Home Assistant currently doesn't support translating calendar items. Therefore, waste collection events in the calendar will always be displayed in English, regardless of your language settings.
131119
132120
## Troubleshooting
133121
134122
There are no commonly known issues with this integration.
135123
136124
## Removing the integration
137125
138-
This integration follows standard integration removal. No extra steps are
139-
required.
126+
This integration follows standard integration removal. No additional steps are required.
140127
141128
{% include integrations/remove_device_service.md %}

0 commit comments

Comments
 (0)