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,FREEMAIL_FROM autolearn=ham autolearn_force=no version=3.4.4 X-Google-Thread: a07f3367d7,9124c8b7efcea462 X-Google-Attributes: gida07f3367d7,public,usenet X-Google-NewGroupId: yes X-Google-Language: ENGLISH,UTF8 Path: g2news1.google.com!news1.google.com!news.glorb.com!gegeweb.org!aioe.org!not-for-mail From: =?utf-8?Q?Hibou57_=28Yannick_Duch=C3=AAne?= =?utf-8?Q?=29?= Newsgroups: comp.lang.ada Subject: Re: Ada and Doxygen Date: Sat, 27 Feb 2010 15:25:08 +0100 Organization: Ada At Home Message-ID: References: <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net> NNTP-Posting-Host: ECkKUhyjlgP2+4RVn5Pp2Q.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed; delsp=yes Content-Transfer-Encoding: Quoted-Printable X-Complaints-To: abuse@aioe.org X-Notice: Filtered by postfilter v. 0.8.2 User-Agent: Opera Mail/10.10 (Win32) Xref: g2news1.google.com comp.lang.ada:9343 Date: 2010-02-27T15:25:08+01:00 List-Id: Le Sat, 27 Feb 2010 15:00:18 +0100, Stephen Leake = a =C3=A9crit: > Most documents I read that have "pre-designed navigation paths" are > tutorials. Or fiction novels, in another domain. > > Reference manuals should not have pre-designed paths; they should > allow random access, with lots of cross-references. What would you say about a handbook ? -- = No-no, this isn't an oops ...or I hope (TM) - Don't blame me... I'm just= = not lucky