Use the new style for configuration variables description

[fabaff]

A while back an advance way to describe the configuration variables was introduced.

{% configuration %}
api_key:
  description: The API key to access the service.
  required: true
  type: string
name:
  description: Name to use in the frontend.
  required: false
  default: The default name to use in the frontend.
  type: string
{% endconfiguration %}

At the moment not all platform and component documentation is ported to the new style.

This the tracking issue. Please don't close but add as a reference to your Pull request.

[WofWca]

Should we open individual PRs for each page changed?

[fabaff]

Yes, please or at least don't add 50 platforms to one Pull Request. If you want you can combine the changes for a component and its platforms.

If the Pull Requests are small it easier to spot for others which docs are in progress or already done.

[WofWca]

I think that the documentation, in accordance to which these changes must be done, is a bit outdated.
home-assistant/developers.home-assistant#104

[fabaff]

@WofWca, Doc were updated. Please feel free to improve them if you think that something is not clear.. Thanks for the feedback, BTW.

[klaasnicolaas]

After PR #7154 all the pages are done 😄

[farmio]

How should a configuration variable be described when it represents an enum (a string with only several acceptable values in my case)?
Just type: string and all possible values listed in the description or type: string together with keys: key?

[frenck]

@farmio For YAML, it is still just a string...

[frenck]

The last PR, #7154 has been finished and merged.

Therefore, this issue can be closed! 🎉

Thank you all for your contributions. 👍 ❤️

A major shoutout to @klaasnicolaas who has done an impressive amount of PRs on this issue!🥇