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=-0.3 required=5.0 tests=BAYES_00, REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no version=3.4.4 X-Google-Thread: 103376,666bab5bfbdf30c2 X-Google-NewGroupId: yes X-Google-Attributes: gida07f3367d7,domainid0,public,usenet X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news2.google.com!news3.google.com!feeder.news-service.com!2a02:590:1:1::196.MISMATCH!news.teledata-fn.de!newsfeed.arcor.de!newsspool1.arcor-online.net!news.arcor.de.POSTED!not-for-mail From: "Dmitry A. Kazakov" Subject: Re: Generating PDFs with Ada Newsgroups: comp.lang.ada User-Agent: 40tude_Dialog/2.0.15.1 MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Reply-To: mailbox@dmitry-kazakov.de Organization: cbb software GmbH References: <4d2908c7$0$22120$742ec2ed@news.sonic.net> <9f23e50a-2c2c-4ccc-bd56-f6ffdc6c7ee7@37g2000prx.googlegroups.com> <82aaj73jsr.fsf@stephe-leake.org> <7a048419-1126-45b2-bfa9-26f3ad6e480e@fu15g2000vbb.googlegroups.com> Date: Sun, 16 Jan 2011 17:44:34 +0100 Message-ID: <1n31s338erb0e$.19ohtik1srnpt$.dlg@40tude.net> NNTP-Posting-Date: 16 Jan 2011 17:44:29 CET NNTP-Posting-Host: b62e087c.newsspool4.arcor-online.net X-Trace: DXC=PWd4l52XjlNA@P]\D4IUK0YE>0KM^d?1?6DcUiM X-Complaints-To: usenet-abuse@arcor.de Xref: g2news2.google.com comp.lang.ada:17427 Date: 2011-01-16T17:44:29+01:00 List-Id: On Sun, 16 Jan 2011 15:33:25 +0000, Simon Wright wrote: > "Dmitry A. Kazakov" writes: > >> On Sun, 16 Jan 2011 11:59:18 +0000, Simon Wright wrote: >> >>> Suppose we decide to have books with chapters with paragraphs. Are we >>> going to say >>> >>> >>> >>> >> >> Let's not. Documents have no such structure. When imposed on, this >> structure makes usage of the documents very difficult. I have to work with >> many documents on networking issues, they are mostly in PDF. These are >> almost unusable *because* they are 1) in PDF, 2) structured as "books," >> which they are not, and never should have been. >> >> A hierarchy of text segments (chapter, paragraph etc) is a possible view of >> the document, of which importance is quite minor and becoming more and more >> negligible, because documents are never read sequentially. Document is not >> a fiction novel. The structure of pages is also a view, a harmful view, >> because pages have nothing to do either with the content or with the >> rendering on the display. > > Well, you've lost me there. If you had to write something on networking > issues (I say 'something' because if you're going to chuck out book, > chapter, paragraph etc you might as well go the whole hog and chuck out > document too :) how would you structure it? It should be an interlinked network of text pieces. Its representation should depend on the current view, especially the order and the visibility of its parts. Consider Ada's RM, ARM and the Rationale as one document. It is impossible to have as a structure of chapters, it just does not work. Further, text is not the only part of the document. There are links which should be rendered in the text. They should also be rendered outside the text as a graph, a cloud diagram, etc. There are bookmarks, history of text navigation, history of document changes, readers comments etc. You mentioned Wiki, which obviously is a far better presentation model or electronic documentation than PDF. So far I saw no satisfactory ideas of how computer-era documentation should be made. -- Regards, Dmitry A. Kazakov http://www.dmitry-kazakov.de