Re: Is the Documentation In a spec File Usually Enough For You ?

["Jeffrey R. Carter" <spam.jrcarter.not@spam.not.acm.org>]

On 10/18/18 11:06 AM, AdaMagica wrote:
> Am Dienstag, 16. Oktober 2018 18:57:51 UTC+2 schrieb Jeffrey R. Carter:
>>
>> That the function returns the same password for the same inputs, and the
>> passwords have all the desirable features for generated passwords:  they appear
>> random, contain characters from all the major food groups, and give away nothing
>> about the master password.
> 
> This is what I mean. There is no requirement defined for this operation. So how can I as a user know what I get? So you have to put this in the spec as a description. Then a user can make test to check whether the claims are true.

I'm not sure I agree. This is package Password_Generation, function Generate, a 
service to generate passwords. I think that is clear from the code and needs no 
further explanation. The description above is simply the definition of a good 
generated password.

I don't think this spec should be a tutorial on password generation. Someone 
looking at it wants to generate passwords, and should know why one generates 
passwords and what the qualities of a good generated password are.

-- 
Jeff Carter
"Well, a gala day is enough for me. I don't think
I can handle any more."
Duck Soup
93