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!news.eternal-september.org!news.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail From: erlo Newsgroups: comp.lang.ada Subject: Re: Documentation tools and standards? Date: Fri, 13 Dec 2013 23:37:52 +0100 Organization: A noiseless patient Spider Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Injection-Date: Fri, 13 Dec 2013 22:37:52 +0000 (UTC) Injection-Info: mx05.eternal-september.org; posting-host="f047e3e707c249e3e510f2617e1f597c"; logging-data="27791"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX19Ld1sFHjKskEJsoIXOn4GA" User-Agent: Mozilla/5.0 (X11; Linux i686; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 In-Reply-To: Cancel-Lock: sha1:R9a9KxzeJ/cA//GTsmlMLS2dR8o= Xref: news.eternal-september.org comp.lang.ada:18024 Date: 2013-12-13T23:37:52+01:00 List-Id: On 12/13/2013 10:23 PM, Diogenes wrote: > I'm at the point where I really should be doing a formal Requirements, Architecture/DDD, and Technical Docs. > > As far as the Requirements and Arch docs, are there any published standards and tools that the Ada community generally prefers when working with Ada code? Any links to those standards? > > As far as the technical documentation...do you guys typically use Doxygen,POD,NDoc, etc..? Which one seems to work best for you? > > Tips and pointers are appreciated. > > Diogenes > I don't think that Doxygen supports Ada, but there is a tool called AdaDoc that will. You can find it on sourceforge http://adadoc.sourceforge.net/ Erlo