Will Berkeley has posted comments on this change.

Change subject: IMPALA-3603 [DOCS] Document handling of NaN values
......................................................................


Patch Set 2:

(10 comments)

There's a few instances of extra whitespace. There should be an editor 
configuration in whatever editor you use that will keep it from sneaking in 
(happens to everyone though).

http://gerrit.cloudera.org:8080/#/c/7098/2//COMMIT_MSG
Commit Message:

PS2, Line 13: This information has been added to the subsection
            : "Usage Notes:" in each topic:
            : 
            : "Impala does not evaluate NaN (not a number) values as
            : equal to any other numeric values, including NaN. For
            : example, the following statement, which evaluates
            : equality between two NaN values returns 'false':
The commit message doesn't need to be this detailed. I would just add a  
another sentence or so after your first to say what the change was and why it 
was (should be) changed:

"Added information in the "DOUBLE Data Type" (impala_double.html)
and the "FLOAT Data Type" (impala_float.html) topics to clarify
that Impala does not evaluate NaN as equal to any other floating point number. 
This behavior, while consistent with IEEE 754, might be confusing or surprising 
to users because some well-known databases like postgres behave differently."


PS2, Line 23: For patch set #2
The commit message shouldn't reference the revisions of the patch. It's meant 
to be the summary of the change that someone will read sometime in the future 
so they can quickly understand what was changed and why. The n revisions the 
patch went through aren't relevant.

If you want to detail what you changed between patch sets, comment on the 
review.


http://gerrit.cloudera.org:8080/#/c/7098/2/docs/shared/impala_common.xml
File docs/shared/impala_common.xml:

PS2, Line 2298:       
Extra whitespace. Remove.


PS2, Line 2300: values
I would remove and just say "Impala does not evaluate NaN as equal to any other 
numeric value, including other NaN value"


PS2, Line 2300: (not a number)
Redundant.


PS2, Line 2301: , which evaluates equality
              :         between two NaN values
Redundant.


PS2, Line 2302: returns
Consider "evaluates to" rather than "returns"...I slightly prefer the former to 
the latter, but would be OK with either.


http://gerrit.cloudera.org:8080/#/c/7098/2/docs/topics/impala_double.xml
File docs/topics/impala_double.xml:

PS2, Line 80:     
Extra whitespace.


http://gerrit.cloudera.org:8080/#/c/7098/2/docs/topics/impala_float.xml
File docs/topics/impala_float.xml:

PS2, Line 74:     
Extra whitespace.


PS2, Line 76:     
Extra whitespace.


-- 
To view, visit http://gerrit.cloudera.org:8080/7098
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-MessageType: comment
Gerrit-Change-Id: Id9485b6790d58fafdae32332d2634cbe893d7fb0
Gerrit-PatchSet: 2
Gerrit-Project: Impala-ASF
Gerrit-Branch: master
Gerrit-Owner: Laurel Hale <lau...@cloudera.com>
Gerrit-Reviewer: John Russell <jruss...@cloudera.com>
Gerrit-Reviewer: Will Berkeley <wdberke...@gmail.com>
Gerrit-HasComments: Yes

Reply via email to