From: "Dmitry A. Kazakov" <mailbox@dmitry-kazakov.de>
Subject: Re: Is the Documentation In a spec File Usually Enough For You ?
Date: Mon, 15 Oct 2018 09:22:13 +0200
Date: 2018-10-15T09:22:13+02:00 [thread overview]
Message-ID: <pq1f74$tus$1@gioia.aioe.org> (raw)
In-Reply-To: 7fcdcc97-67e4-473b-abc4-cd0ecd4501ad@googlegroups.com
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
next prev parent reply other threads:[~2018-10-15 7:22 UTC|newest]
Thread overview: 25+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-10-15 0:42 Is the Documentation In a spec File Usually Enough For You ? patrick
2018-10-15 5:44 ` Henrik Härkönen
2018-10-15 7:22 ` Dmitry A. Kazakov [this message]
2018-10-15 7:42 ` Niklas Holsti
2018-10-15 10:05 ` AdaMagica
2018-10-15 11:25 ` patrick
2018-10-15 11:57 ` Markus Schöpflin
2018-10-15 13:02 ` patrick
2018-10-15 16:50 ` Jeffrey R. Carter
2018-10-16 9:57 ` AdaMagica
2018-10-16 16:57 ` Jeffrey R. Carter
2018-10-18 9:06 ` AdaMagica
2018-10-18 15:24 ` Brad Moore
2018-10-18 17:29 ` Jeffrey R. Carter
2018-10-18 17:54 ` AdaMagica
2018-10-18 18:50 ` Dennis Lee Bieber
2018-10-18 20:07 ` Jeffrey R. Carter
2018-10-21 15:20 ` AdaMagica
2018-10-21 18:56 ` Jeffrey R. Carter
2018-10-22 16:04 ` AdaMagica
2018-10-22 19:13 ` Jeffrey R. Carter
2018-10-23 10:00 ` AdaMagica
2018-10-18 21:24 ` Randy Brukardt
2018-10-19 7:39 ` J-P. Rosen
2018-10-20 1:27 ` Randy Brukardt
replies disabled
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox