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!feeder.eternal-september.org!aioe.org!.POSTED!not-for-mail From: "Dmitry A. Kazakov" Newsgroups: comp.lang.ada Subject: Re: Is the Documentation In a spec File Usually Enough For You ? Date: Mon, 15 Oct 2018 09:22:13 +0200 Organization: Aioe.org NNTP Server Message-ID: References: <7fcdcc97-67e4-473b-abc4-cd0ecd4501ad@googlegroups.com> NNTP-Posting-Host: MyFhHs417jM9AgzRpXn7yg.user.gioia.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Complaints-To: abuse@aioe.org User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 X-Notice: Filtered by postfilter v. 0.8.3 Content-Language: en-US Xref: reader02.eternal-september.org comp.lang.ada:54575 Date: 2018-10-15T09:22:13+02:00 List-Id: On 2018-10-15 02:42, patrick@spellingbeewinnars.org wrote: > The thing is, that the Ada libraries come with almost no documentation/example code at all. Some specific libraries in mind? > Do you find that just reading through the spec files is enough for you to understand how to use the library in most cases? I was thinking I would try more of them out but I also wonder if I am about to go off on a suicide mission. Usually specifications is all you need. Tricky stuff must be explained of course, especially things which specifications do not cover: exception contracts, behavior under tasking, numeric complexity etc. Frameworks is a different kind of thing, they always require getting started, examples etc, regardless the language. -- Regards, Dmitry A. Kazakov http://www.dmitry-kazakov.de