discuss: Revision history at end of document
Subject:
Re: Revision history at end of document
From:
rahulsundaram ####@####.####
Date:
15 Jan 2004 05:47:05 -0000
Message-Id: <40062925.2060601@yahoo.co.in>
David Lawyer wrote:
>On Wed, Jan 14, 2004 at 02:22:54PM -0800, Tabatha Marshall wrote:
>
>
>>On Wed, 2004-01-14 at 14:19, Tabatha Marshall wrote:
>>
>>
>>
>>>My position on it has always been that it's important to see SOMETHING
>>>in the revhistory, if the document is in DocBook.
>>>
>>>
>
>Why should it be any different than LinuxDoc? The revision history
>should be optional in my opinion.
>
>There is a problem with DocBook docs that I've just looked at since they
>have neither a version number nor a date except in the revision history.
>Also some DocBook docs have long revision histories at the start which
>interferes with reading them. One looks at the doc and doesn't even see
>the table of contents unless one scrolls down. I think that the
>template is part of the problem since the template has no <date> tag (or
>the like). In Linuxdoc, both the version number and the date go under
>the <date> tag. In DocBook ??? but I suspect it's a lot more
>complicated.
>
>
David - We understand that docbook has problems and you consider
linuxdoc to be superior. It would be much better if you present *all*
the possible problems in a single document somewhere so that all the
users of docbook can read it and understand the problems including me
regards
Rahul Sundaram