Skip to content

Add documentation for the new watson_iot component#5100

Merged
balloob merged 6 commits intohome-assistant:nextfrom
mtreinish:watson-iot
Jun 21, 2018
Merged

Add documentation for the new watson_iot component#5100
balloob merged 6 commits intohome-assistant:nextfrom
mtreinish:watson-iot

Conversation

@mtreinish
Copy link
Copy Markdown
Contributor

Description:

This commit adds documention for the new watson_iot component which was
added in home-assistant/core#13664
It links to the official documentation for setting up the cloud service
and generating the required auth information.

Pull request in home-assistant (if applicable): home-assistant/core#13664

Checklist:

  • Branch: Fixes, changes and adjustments should be created against current. New documentation for platforms/components and features should go to next.
  • The documentation follow the standards.

This commit adds documention for the new watson_iot component which was
added in home-assistant/core#13664
It links to the official documentation for setting up the cloud service
and generating the required auth information.
Comment thread source/_components/watson_iot.markdown Outdated
token: 'auth_token'
```

Configuration variables:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please use the configuration tags, for more information please see:
https://home-assistant.io/developers/documentation/create_page/#configuration

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, I pushed a patch to use the configuration tags

@frenck
Copy link
Copy Markdown
Member

frenck commented Apr 4, 2018

Thank you for this PR @mtreinish! I've reviewed it and found one abnormality.
Could you please take a look? 👍

@frenck frenck added the new-integration This PR adds documentation for a new Home Assistant integration label Apr 4, 2018
This commit updates the formatting of the configuration section of the
documentation. Previously it manually formatted a list instead of
leveraging the templating format. This corrects that oversight and uses
the standard format.
@frenck frenck self-assigned this Apr 4, 2018
frenck
frenck previously approved these changes Apr 5, 2018
@frenck
Copy link
Copy Markdown
Member

frenck commented Apr 5, 2018

Thanks for updating the PR @mtreinish! 👍
✅ Approved, can be merged as soon as the parent PR gets merged.

Bonus: Maybe add the IBM or IBM Watson logo?

@frenck frenck assigned frenck and unassigned frenck and mtreinish Apr 5, 2018
frenck
frenck previously approved these changes Apr 5, 2018
@frenck frenck removed their assignment Apr 5, 2018
frenck
frenck previously approved these changes Apr 6, 2018

To use this component, you first need to register a gateway device type and then
a gateway device in your IoT platform instance. For instructions on how to do
this check the [official documentation](https://console.bluemix.net/docs/services/IoT/gateways/dashboard.html#IoT_connectGateway)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please indicate whether it is FREE or paid so that users are not wasting their time.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

They have a free tier, which is sufficient imho.

Comment thread source/_components/watson_iot.markdown Outdated
footer: true
logo: ibm.png
ha_category: History
ha_release: 0.68
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remember to update the release.

Comment thread source/_components/watson_iot.markdown Outdated
ha_release: 0.68
---

The `watson_iot` component enables you to link the devices in home-assistant
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

home-assistant -> Home Assistant

@mtreinish mtreinish closed this May 17, 2018
@mtreinish mtreinish reopened this May 24, 2018
@frenck frenck added this to the 0.72 milestone Jun 17, 2018
@frenck frenck self-assigned this Jun 17, 2018

To use this component, you first need to register a gateway device type and then
a gateway device in your IoT platform instance. For instructions on how to do
this check the [official documentation](https://console.bluemix.net/docs/services/IoT/gateways/dashboard.html#IoT_connectGateway)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I suggest adding a line about why you would use this component? "i.e. you can use this to bring IoT history data into Watson to build an application..." My thought is that people will see Watson and think they will get some out of the box analytics or machine learning.

@balloob balloob merged commit 7612de9 into home-assistant:next Jun 21, 2018
@balloob balloob added the cherry-picked This PR has been manually picked and merged into the current branch label Jun 21, 2018
balloob pushed a commit that referenced this pull request Jun 21, 2018
* Add documentation for the new watson_iot component

This commit adds documention for the new watson_iot component which was
added in home-assistant/core#13664
It links to the official documentation for setting up the cloud service
and generating the required auth information.

* ✏️ Missing comma

* Use configuration tags

This commit updates the formatting of the configuration section of the
documentation. Previously it manually formatted a list instead of
leveraging the templating format. This corrects that oversight and uses
the standard format.

* 🎨 Adds logo

* ⬆️ ha_release -> 0.68

* ✏️ Processed RFC's
@mtreinish mtreinish deleted the watson-iot branch October 9, 2018 13:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cherry-picked This PR has been manually picked and merged into the current branch new-integration This PR adds documentation for a new Home Assistant integration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants