Re: Datamash documentation feedback

[Eric Powell]

These look like some good corrections

On Tue, Apr 20, 2021, 6:41 PM David Apps <sppa.divad@virgin.net> wrote:

I hope that you are well.

Thank you for your work on this great software.

I have some feedback on parts of the documentation:

https://www.gnu.org/software/datamash/manual/datamash.html

This page includes the following words:

"quarile"
"Similary"
"quariles"
"simuated"

I think that these are typing mistakes.

Please can you fix these typing mistakes and run a spell check facility
to find others?

https://www.gnu.org/software/datamash/examples/

"GNU datamash is command-line program which performs simple calculation"
Perhaps change this to:
"GNU datamash is a command-line program that performs simple calculations"

"The files has three columns:"
Perhaps change this to:
"The file has three columns:"

"Similarly, find the number of students, mean score and
sample-standard-deviation for each College major:"
Perhaps change this to:
"Similarly, find the mean score and sample standard deviation for each
College major:"
(The example does not count the number of students.)

"Datamash can generate header line in the output file"
Perhaps change this to:
"Datamash can generate a header line in the output file"

"$ datamash --header-out -g 2 count 3 mean 3 pstdev 3 < scores.txt"
Perhaps change this to:
"$ datamash --header-out -g 2 mean 3 pstdev 3 < scores.txt"

"$ datamash -H -g 2 count 3 mean 3 pstdev 3 < scores_h.txt"
Perhaps change this to:
"$ datamash -H -g 2 mean 3 pstdev 3 < scores_h.txt"

"How many transcripts are in each chromsome AND strand?"
Perhaps change this to:
"How many transcripts are in each chromosome AND strand?"

"Calculating the Five-Number Summary: of all values in the first column
of the input file: "
Perhaps change this to:
"Calculating the Five-Number Summary of all values in the first column
of the input file: "

"Finding out the count,mean and sample standard-deviation: "
Perhaps change this to:
"Finding the count, mean, and sample standard deviation: "

https://www.gnu.org/software/datamash/alternatives/

"If you have suggestions and/or improvement to the one-liner examples below"
Perhaps change this to:
"If you have suggestions or improvements to the one-liner examples below"

"However, using AWK without additional input validation and error
checking code will silently ignore incorrent input and produce incorrect
output:"
Perhaps change this to:
"However, using AWK without additional input validation and error
checking code will silently ignore incorrect input and produce incorrect
output:"

"awk and Perl can be used to perform equivalent Datamash operations,
such as calculating the sum, minimum value, maximum value, unique values
of groupped input data."
Perhaps change this to:
"AWK and Perl can be used to perform equivalent Datamash operations,
such as calculating the sum, minimum value, maximum value, and unique
values of grouped input data."

"The awk and Perl versions has the advantage of not need to sort the input"
Perhaps change this to:
"The AWK and Perl versions have the advantage of not needing to sort the
input"

"Other languages (such as Perl,awk,shell) also offer one-liners to
transpose a file, but their solution usually do not detect invalid input:"
Perhaps change this to:
"Other languages (such as Perl, AWK, and shell) also offer one-liners to
transpose a file, but their solutions usually do not detect invalid input:"

Thank you.

David