Make it clearer that users have to install OAuth credentials for nest integration setup

[ryanmahan]

Clarify instructions for adding OAuth credentials in Home Assistant to push users towards installing them

Proposed change

The language for installing the applications credentials could be stronger here. The current language reads like this step and the link to Application Credentials is informational. This PR changes the language to make it clear that there is an action the user needs to take.

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).
  • I've opened up a PR to add logos and icons in Brands repository.
• Added documentation for a new feature I'm adding to Home Assistant (next branch).
• Removed stale or deprecated documentation.

Additional information

• Link to parent pull request in the codebase:
• Link to parent pull request in the Brands repository:
• This PR fixes or closes issue: fixes #

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.

[netlify]

✅ Deploy Preview for home-assistant-docs ready!

Name	Link
🔨 Latest commit	3f4d45e
🔍 Latest deploy log	https://app.netlify.com/projects/home-assistant-docs/deploys/6921aabbdd4792000893dc10
😎 Deploy Preview	https://deploy-preview-41793--home-assistant-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

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

[allenporter]

The reason the wording is this way is because you are asked for these credentials during integration setup, so its not necessary to do additional step to add them as you'll be asked for them. I agree with your point here, though perhaps we should say that you can add them manually or add them when the integration asks you for them?

[ryanmahan]

Sounds like my confusion here was just my own user error. I had an old token set up in application credentials for nest that I believe had expired. Didn't see a prompt during the set up to input the client secret and missed that it needed to be replaced

[allenporter]

Well it definitely can be confusing because it doesn't ask you again if the credentials are already setup. It just uses them, assuming you want to use them and home assistant can't tell if there is an error with them.

[frenck]

I agree, I also think the current wording suggested doesn't harm.

So, let's move forward on getting this PR into a resoluted state 👍

../Frenck

[frenck]

Thanks, @ryanmahan 👍

../Frenck

                       

Blogging my personal ramblings at frenck.dev