Improve the language used in YAML deprecation warnings

[reef-actor]

It seems like whenever an integration is moved from YAML to UI, there are worried posts about the integration being removed.

[FALSE] System Monitor deprecated; what to use else?

Hi, Currently I’m using “System Monitor” to read the process usage, space etc from my Home Assistant PI. Since the last Home assistant core update; it states this will be deprecated in 6 months. What should I use instead to monitor my PI running Home Assistant Core? Thanks in advance,

This seems to originate in the clumsy arrangement of the warning message.
Maybe this error message makes more sense in other languages, but in English it seems odd in places and factually incorrect in others.

The System Monitor YAML configuration is being removed
No it isn’t. The configuration is still there and will stay there until the user removes it.

This stops working in version 2024.7.0. Please address before upgrading.
“This”? What is “This”? We keep seeing confusion and panic caused by this line. Address it how?

Configuring System Monitor using YAML is being removed.
Grammar has left the building.

Your existing YAML configuration has been imported into the UI automatically.
This is reassuring and should be mentioned earlier

Remove the systemmonitor configuration from your configuration.yaml file and restart Home Assistant to fix this issue.
It seems a little unnecessary to require the user restarts? As far as I know you cannot upgrade HA without it restarting?

Keeping it simple with what has changed and what action is required communicates the point much more clearly.

System Monitor configuration is now achieved through the Integrations page

Your System Monitor configuration has been imported and can safely be removed from the YAML file. You will need to do this before version 2024.7.0 to avoid errors.

Does that not seem like a more digestible communication?

[finity]

A bit better might be:

The System Monitor integration is being changed to only allow configuration via the UI.

Your existing System Monitor YAML configuration has been imported and can safely be removed from the configuration.yaml file. You will need to do this before version 2024.7.0 to avoid errors.

The new configuration can be accessed on the “Integrations” tab of the “Devices and Services” section of the “Settings” menu**

[parautenbach (Pieter Rautenbach)]

@reef-actor

System Monitor configuration is now achieved through the Integrations page

I’d say:

The system monitor integration is now configured through the integrations page.

Or, to be more robust against future changes:

The system monitor integration is now configured through the UI.

(My personal preference is to use via over through.)

If one wants to put it more technically:

The system monitor integration’s configuration has been migrated from YAML to internal storage.

Technically accurate, but less user friendly.