Skip to content

Forecasts for weather underground#2414

Merged
balloob merged 3 commits into
home-assistant:currentfrom
pezinek:wu_forecasts
May 7, 2017
Merged

Forecasts for weather underground#2414
balloob merged 3 commits into
home-assistant:currentfrom
pezinek:wu_forecasts

Conversation

@pezinek
Copy link
Copy Markdown
Contributor

@pezinek pezinek commented Apr 11, 2017

Description:

This PR allows forecasts for the Weather Underground component.

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

@mention-bot
Copy link
Copy Markdown

@pezinek, thanks for your PR! By analyzing the history of the files in this pull request, we identified @arsaboo, @tchellomello and @fabaff to be potential reviewers.

@Landrash Landrash added new-feature This PR adds documentation for a new Home Assistant feature to an existing integration and removed Enhancement labels Apr 12, 2017
Copy link
Copy Markdown
Contributor

@Landrash Landrash left a comment

Choose a reason for hiding this comment

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

Looks good with some minor feedback.


<p class='note'>
<a name="1d">[1d]</a> - For daily forecasts, you could replace the number
in ```_1d_``` part of the sensor name only. Valid values are from
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.

One set of ` is enough to wrap a variable.

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.

Fixed.

All the conditions listed above will be updated each 5 minutes with exception of `alerts` that will be updated each 15 minutes by default.
All the conditions listed above will be updated every 5 minutes.

<p class='note'>
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.

Most of the changes are in notes now. Would it not be preferable to avoid their use for readability?

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.

Might be easier to follow if the forecast options were broken out into their own section independent of the standard monitoring options.

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've removed the notes and replaced them with with "plain text".
Dissecting the forecast options to special section would be problematic as they logically belong to the monitored conditions list. But I'm open to further suggestions.

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.

I think after reading the "additional examples" this will work fine. I would just strongly suggest adding a section header "Forecast" after the words "All the conditions listed above will be updated every 5 minutes." to separate them for readability. Otherwise, I am so anxious to see this merged! Thank you.

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, added the "Forecasts" header, how does it look now ?

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.

Great! Thanks; I think it helped.

@pezinek
Copy link
Copy Markdown
Contributor Author

pezinek commented Apr 19, 2017

Updated to address the suggestions from the review.

Copy link
Copy Markdown
Contributor

@Landrash Landrash left a comment

Choose a reason for hiding this comment

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

One minor feedback but looks good in general.

</p>
Monitored conditions marked with <a name="12h">[12h]</a> are 12 hour
forecasts. To get a forecast for different period/daytime replace the
`_1d_` part of the sensor name. e.g. `weather_2n` will give you forecast for
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.

This one is a mix of 12h and 1d. On purpose of a mistake?

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.

This is on purpose, in fact what I call 12h forecast here is called daily forecast by the WU API, the problem is that for some conditions they do provide more fine grained granularity and provide values for day and night, and for some they don't, so I just wanted to make the sensor naming a bit more uniform and let users use the same convention, unless they really do care about what happens outside during nighttime.

All the conditions listed above will be updated each 5 minutes with exception of `alerts` that will be updated each 15 minutes by default.
All the conditions listed above will be updated every 5 minutes.

<p class='note'>
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.

Great! Thanks; I think it helped.

@pezinek
Copy link
Copy Markdown
Contributor Author

pezinek commented Apr 24, 2017

Hi, is there something else expected from me before this PR could be approved ?

@rpitera
Copy link
Copy Markdown
Contributor

rpitera commented Apr 24, 2017

I think there is just the one change that Landrash suggested.

@pezinek
Copy link
Copy Markdown
Contributor Author

pezinek commented Apr 25, 2017

Actually I believe I addressed all the issues Landrash pointed out either by fixing the code or by explaining in the comments. Would you mind to point me again to the issues you believe I still have to address ?

@rpitera
Copy link
Copy Markdown
Contributor

rpitera commented Apr 25, 2017

The only thing I can see in red is the comment around 115 - "-All the conditions listed above will be updated each 5 minutes with exception of alerts that will be updated each 15 minutes by default."

@pezinek
Copy link
Copy Markdown
Contributor Author

pezinek commented Apr 25, 2017

That one is intentional change and not a mistake, as I explained in the comments, so I believe this PR is ready for approval, unless you strongly disagree with my explanation ;-)
@Landrash are you OK with my explanation above / would you mind to approve this PR eventually ?

@rpitera
Copy link
Copy Markdown
Contributor

rpitera commented Apr 26, 2017

That one is intentional change and not a mistake, as I explained in the comments, so I believe this PR is ready for approval, unless you strongly disagree with my explanation ;-)

I've already approved. Just waiting on @Landrash now.

@Landrash
Copy link
Copy Markdown
Contributor

Looks good and can be merged when parent pr is merged.

@pezinek
Copy link
Copy Markdown
Contributor Author

pezinek commented Apr 27, 2017

@Landrash: Thanks !

@rpitera
Copy link
Copy Markdown
Contributor

rpitera commented Apr 27, 2017

@pezinek: And thanks to you for this! I'd almost given up hope of getting this into HA.

@balloob balloob changed the base branch from next to current May 7, 2017 01:07
@balloob balloob merged commit c5851c3 into home-assistant:current May 7, 2017
@pezinek pezinek deleted the wu_forecasts branch May 29, 2017 08:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-feature This PR adds documentation for a new Home Assistant feature to an existing integration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants