From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable autolearn_force=no version=3.4.4 Path: eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!.POSTED!not-for-mail From: "Jeffrey R. Carter" Newsgroups: comp.lang.ada Subject: Re: Is the Documentation In a spec File Usually Enough For You ? Date: Thu, 18 Oct 2018 19:29:14 +0200 Organization: Also freenews.netfront.net; news.tornevall.net; news.eternal-september.org Message-ID: References: <7fcdcc97-67e4-473b-abc4-cd0ecd4501ad@googlegroups.com> <8f6c0bfa-f7ed-4bee-a766-c786269f13a1@googlegroups.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Date: Thu, 18 Oct 2018 17:29:15 -0000 (UTC) Injection-Info: reader02.eternal-september.org; posting-host="9b384ee32d3245b5b72c9b947589f809"; logging-data="31678"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1/gTd0BnZ4cEb71poLk+MmoaL94U2SKJuk=" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.2.1 Cancel-Lock: sha1:bnVYsDhTXXUUUrDXL6MzvA8bGUE= In-Reply-To: Content-Language: en-US Xref: reader02.eternal-september.org comp.lang.ada:54632 Date: 2018-10-18T19:29:14+02:00 List-Id: 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