db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bryan Pendleton (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-6830) Add user documentation for var_pop(), var_samp(), stddev_pop(), and stddev_samp()
Date Sat, 15 Aug 2015 01:35:45 GMT

    [ https://issues.apache.org/jira/browse/DERBY-6830?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14698038#comment-14698038
] 

Bryan Pendleton commented on DERBY-6830:
----------------------------------------

The pages look great to me, thanks for writing them.

I suppose that the abbreviations "pop" => "population", "samp" => "sample",
"var" => "variance", and "stddev" => "standard deviation" are fairly well
known to statisticians (I am not one such)?

I wonder if there is a place in our documentation for a glossary entry that
makes those abbreviations more obvious? Or some sort of indexing?

Beyond that abstract comment, the only other thing I noticed was that
the description of STDDEV_POP didn't actually use the word "population"
in its description, while all the other functions included their complete
terms (variance/sample/population/standard deviation) in their description.

Does that indicate that this description is slightly inadequate (should say
"population" in it somewhere)?

+<shortdesc>STDDEV_POP is an aggregate function that evaluates the
+ standard deviation of an expression over a set of rows.</shortdesc>

None of these comments should hold up the doc commit; the docs are
very helpful as is.

> Add user documentation for var_pop(), var_samp(), stddev_pop(), and stddev_samp()
> ---------------------------------------------------------------------------------
>
>                 Key: DERBY-6830
>                 URL: https://issues.apache.org/jira/browse/DERBY-6830
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.12.0.0
>            Reporter: Rick Hillegas
>            Assignee: Rick Hillegas
>         Attachments: derby-6830-01-aa-refguide.diff, derby-6830-01-aa-refguide.tar
>
>
> Add user documentation for the new aggregates added by DERBY-5466.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message