[R] what constitutes a 'complete sentence'?

Rolf Turner r.turner at auckland.ac.nz
Mon Jul 6 23:09:54 CEST 2015


On 07/07/15 07:10, William Dunlap wrote:

[Rolf Turner wrote.]

>> The CRAN guidelines should be rewritten so that they say what they *mean*.
>> If a complete sentence is not actually required --- and it seems abundantly clear
>> that it is not --- then guidelines should not say so.  Rather they should say,
>> clearly and comprehensibly, what actually *is* required.
>
> This may be true, but also think of the user when you write the description.
> If you are scanning a long list of descriptions looking for a package to
> use,
> seeing a description that starts with 'A package for' just slows you down.
> Seeing a description that includes 'designed to' leaves you wondering if the
> implementation is woefully incomplete.  You want to go beyond what CRAN
> can test for.

All very true and sound and wise, but what has this got to do with 
complete sentences?  The package checker issues a message saying that it 
wants a complete sentence when this has nothing to do with what it 
*really* wants.

cheers,

Rolf

-- 
Technical Editor ANZJS
Department of Statistics
University of Auckland
Phone: +64-9-373-7599 ext. 88276



More information about the R-help mailing list