[
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)
