Mention of the 15 minute waiting period with calendars

[crispy78]

Feedback

When testing, make sure you do not plan events less than 15 minutes away from the current time, or your trigger might not fire.

Personally I think this "warning" should have a more prominent place in the docs. I don't think I'm the only person that'll test their automation after creation, that 15 minute waiting period is something you must take into account when testing.

I'd prefer the following:

Automation

Calendar Triggers enable automation based on an event’s start or end. Review the Automating Home Assistant getting started guide on automations or the Automation documentation for full details.

Calendar triggers are the best way to automate based on calendar events. A calendar entity can also be used to automate based on its state, but these are limited and attributes only represent the next event. Note that calendars are read once every 15 minutes. When testing, make sure you do not plan events less than 15 minutes away from the current time, or your trigger might not fire.

URL

https://www.home-assistant.io/integrations/calendar/

Version

2024.5.1

Additional information

No response

[home-assistant]

Hey there @home-assistant/core, mind taking a look at this feedback as it has been labeled with an integration (calendar) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of calendar can trigger bot actions by commenting:

• @home-assistant close Closes the feedback.
• @home-assistant rename Awesome new title Renames the feedback.
• @home-assistant reopen Reopen the feedback.
• @home-assistant unassign calendar Removes the current integration label and assignees on the feedback, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information) to the feedback.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information) on the feedback.