-
Notifications
You must be signed in to change notification settings - Fork 300
is_circular: grib load tests and what's new #2167
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
| @@ -0,0 +1,2 @@ | |||
| - Fixed a bug where the :func:`iris.util._is_circular` would return false where | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Previously we started each contribution with a *, should we keep consistency with that? I know - is the correct character, but * is also allowed, and mixing them in a single list would be a bad idea so we have to pick one.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
i'd rather stick with '-'
as this is the first entry for this collection, perhaps it can set a precedent?
I believe that the 1.10 contributions mixed the - and * use
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fine, I'd prefer if we tried to stick to the same throughout, but depending on restructured-text backend it is worst case a warning if you mix them, so I guess it doesn't matter as much as I thought.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@marqh LGTM ... but @ajdawson is right, after a quick scan through the last few whatsnew all points are marked with * ...
... does Sphinx render the html differently with - instead of * ... I can't tell quickly from documentation, and I can't be bother building the docs to see.
http://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html#list-and-bullets doesn't mention the use of -
@marqh could I nudge you in the direction of using * ? Then I'll merge ... I'll even update the dev notes in a separate PR 😉
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It should render fine with either, but if you mix the styles you get a warning from sphinx but the output is likely correct (although in some circumstances the intent may be misinterpreted. I'd advocate using strictly 1 style only.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I vote for *
done ping @bjlittle |
| @@ -0,0 +1,2 @@ | |||
| * Fixed a bug where the :func:`iris.util._is_circular` would return false where | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Now that we've dealt with character number 1, we can move onto the rest 😉 Can it be changed like this:
Fixed a bug where the :func:iris.util._is_circular would erroneously return false where when the coordinate values are decreasing.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Now is that false or False 😉
|
updated with new wording, please squish and merge if you are content |
|
note: tests passed with the first commit, all further commits are just changes to the what's new wording, so you may choose not to wait for travis, if you so desire |
| @@ -0,0 +1,2 @@ | |||
| * Fixed a bug where :func:iris.util._is_circular would erroneously return False | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The markup here is no longer correct, it is missing the back-ticks ( I suspect because copy-paste from the Github comment, which turned the back-ticks into an object). You actually don't need to capitalise False in this usage unless you are referring explicitly to the Python object False...
sorry, i should have spotted that; hopefully fixed now |
required update to
#2164 (already merged :/)