Suggestions for improving HA documentation

You can improve the docs @RangerZ.