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=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!news2.google.com!npeer02.iad.highwinds-media.com!news.highwinds-media.com!feed-me.highwinds-media.com!post02.iad.highwinds-media.com!news.flashnewsgroups.com-b7.4zTQh5tI3A!not-for-mail Newsgroups: comp.lang.ada Subject: Re: Ada and Doxygen References: <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net> From: Stephen Leake Date: Sat, 27 Feb 2010 09:00:18 -0500 Message-ID: User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.2 (windows-nt) Cancel-Lock: sha1:jjRf/5SynWE2toW9Yyvma0GyFWs= MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Complaints-To: abuse@flashnewsgroups.com Organization: FlashNewsgroups.com X-Trace: ec46d4b8925a6e197caa710201 Xref: g2news1.google.com comp.lang.ada:9341 Date: 2010-02-27T09:00:18-05:00 List-Id: "Hibou57 (Yannick Duchêne)" writes: >>> Further more, this kind of browsing does not allow pre-designed >>> navigation paths (this is mainly random browsing -- random here, has >>> the same meaning as with random file access), >> >> Well, yes. >> >> If you want to write a tutorial, that's a separate document, not >> source code. > That's closer. > Why did you use the word “ tutorial ” ? (just want to know, as this > choice may be potentially relevant) 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. -- -- Stephe