Skip to content

Conversation

@wendevlin
Copy link
Member

Proposed change

  • Add docs for input_weekday

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings October 9, 2025 08:00
@home-assistant home-assistant bot added Hacktoberfest An PR on this issue (or the PR itself) is eligible towards Hacktoberfest! has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels Oct 9, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds comprehensive documentation for the new input_weekday integration, which provides a helper for managing weekday selections in Home Assistant automations. The integration allows users to define and dynamically control weekday-based automation triggers and conditions through the UI or YAML configuration.

Key changes:

  • New integration documentation with configuration examples
  • Comprehensive action reference table
  • Practical automation examples showing time triggers and conditions

description: List of initially selected weekdays.
required: false
type: list
default: a previous value is restored if available
Copy link

Copilot AI Oct 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The default description should be more specific and clear. Consider: 'default: Previously selected weekdays are restored when Home Assistant restarts, if available'

Suggested change
default: a previous value is restored if available
default: Previously selected weekdays are restored when Home Assistant restarts, if available

Copilot uses AI. Check for mistakes.
Comment on lines +75 to +82
| Action | Data | Description |
| ----------------- | ------------------- | ------------------------------------------------------------------- |
| `set_weekdays` | `weekdays` | Set the selected weekdays (replaces all current selections) |
| `add_weekday` | `weekday` | Add a single weekday to the selection |
| `remove_weekday` | `weekday` | Remove a single weekday from the selection |
| `toggle_weekday` | `weekday` | Toggle a single weekday (add if not selected, remove if selected) |
| `clear` | | Clear all selected weekdays |
| `reload` | | Reload `input_weekday` configuration |
Copy link

Copilot AI Oct 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This table may not render well on mobile devices. According to the guidelines, tables should be avoided and lists used instead. Consider converting this to a bulleted list format with clear formatting for better mobile readability.

Copilot generated this review using guidance from repository custom instructions.
@netlify
Copy link

netlify bot commented Oct 9, 2025

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit a24848b
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/68e76bb5a1771a00097cb301
😎 Deploy Preview https://deploy-preview-41248--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@c0ffeeca7 c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Oct 9, 2025
ha_integration_type: helper
---

The **Input weekday** helper integration allows you to define a selection of weekdays that can be controlled via the user interface and used within conditions and triggers of an {% term automation %}. This makes it easy to dynamically manage weekday-based automations without having to manually specify weekdays in your automation configuration.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The **Input weekday** helper integration allows you to define a selection of weekdays that can be controlled via the user interface and used within conditions and triggers of an {% term automation %}. This makes it easy to dynamically manage weekday-based automations without having to manually specify weekdays in your automation configuration.
The **Input weekday** helper {% term integration %} allows you to define a selection of weekdays that can be controlled via the user interface. You can then use conditions and triggers on these days for {% term automation %}. This makes it easy to dynamically manage weekday-based automations without having to manually specify weekdays in your automation configuration.

tiny rephrase. Fell free to tweak if you don't like it.

Comment on lines +19 to +22
The preferred way to configure input weekday helpers is via the user interface,
in which they are known as Weekday Helpers. To add one, go to
**{% my helpers title="Settings > Devices & services > Helpers" %}** and click the add button;
next choose the **{% my config_flow_start domain="input_weekday" title="Weekday" %}** option.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The preferred way to configure input weekday helpers is via the user interface,
in which they are known as Weekday Helpers. To add one, go to
**{% my helpers title="Settings > Devices & services > Helpers" %}** and click the add button;
next choose the **{% my config_flow_start domain="input_weekday" title="Weekday" %}** option.
To add a **Weekday Helper**, go to
**{% my helpers title="Settings > Devices & services > Helpers" %}** and select **Add**.
Next, choose the **{% my config_flow_start domain="input_weekday" title="Weekday" %}** option.

**{% my helpers title="Settings > Devices & services > Helpers" %}** and click the add button;
next choose the **{% my config_flow_start domain="input_weekday" title="Weekday" %}** option.

To be able to add **Helpers** via the user interface you should have
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think we can expect the majority of people to have that in their config? If so, I would move this section into a troubleshooting section further down the page.

@home-assistant home-assistant bot marked this pull request as draft October 9, 2025 12:10
@home-assistant
Copy link

home-assistant bot commented Oct 9, 2025

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Hacktoberfest An PR on this issue (or the PR itself) is eligible towards Hacktoberfest! has-parent This PR has a parent PR in another repo new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants