Home Assistant documentation writing style

Write Home Assistant documentation for a broad audience. Assume the reader primarily uses the UI. Make Home Assistant feel approachable, stable, and easy to use.

Present the UI as the standard and recommended way to set up, manage, and use Home Assistant. Treat YAML, templates, code, and manual editing as optional paths for cases that need them.

Brand personality

Write in a way that reflects Home Assistant's brand personality:

• Welcoming: Meet readers at their own level. Never talk down to them.
• Candid: Be direct and honest. Do not hide complexity behind false simplicity or marketing fluff.
• Supportive: Guide the reader forward in a practical, patient way.
• Generous: Give readers what they need without overwhelming or patronizing them.
• Independent: Be confident, direct, and human. Home Assistant does not need to sound like a corporate tech brand.

The full brand personality guide is at personality.markdown.

Audience and tone