discuss: TLDP DocBook pages need work - Start there!


Previous by date: 25 Nov 2003 15:06:23 -0000 wiki3 (was Re: the good the bad and the ugly), Randy Kramer
Next by date: 25 Nov 2003 15:06:23 -0000 Re: new documentation license, Rodolfo J. Paiz
Previous in thread: 25 Nov 2003 15:06:23 -0000 Re: TLDP DocBook pages need work - Start there!, David Lawyer
Next in thread: 25 Nov 2003 15:06:23 -0000 Re: TLDP DocBook pages need work - Start there!, jdd

Subject: Re: TLDP DocBook pages need work - Start there!
From: "Rodolfo J. Paiz" ####@####.####
Date: 25 Nov 2003 15:06:23 -0000
Message-Id: <6.0.0.22.0.20031125085914.025c25c0@mail.simpaticus.com>

At 23:03 11/24/2003, David Lawyer wrote:
>Here's an example of some differences:
>----------------------------------------------------------------------
>             Comparison of DocBook to LinuxDoc (short).
>         by David Lawyer, June 23, 2000, revised July 2001
>
>Using DocBook instead of LinuxDoc requires many more tags and the tags
>tend to be longer.  DocBook tags tend to be nested.  The tag clutter
>makes DocBook harder to read.  Thus DocBook is not nearly as easy to
>do by hand.  Even with an editor that supports it, there is a lot
>more complexity to DocBook.

David,

I find your "example of some differences" biased, subjective, and 
irrelevant. You have not noted any specific differences (not one!), and 
only made comparative statements that were _all_ favorable to Linuxdoc, of 
which you are an open advocate. Now, it's fine that you have your opinion, 
and it's fine that you state your opinion clearly, but these are not 
differences, these are not examples, and the entire text achieves exactly 
nothing when attempting to answer the original question:

On Sun, Nov 23, 2003 at 01:51:16PM -0500, John R. Daily wrote:
 > What is the functional difference between LinuxDoc and a
 > comparable subset of DocBook tags[1] with a well-defined toolchain?

That question has not been answered. Personally, I like DocBook as being 
more flexible and more scalable (things that come along with the increased 
complexity you decry). However, I do not care about either my subjective 
opinion or yours on this matter.

What I _would_ like to see, if someone more knowledgeable cares to offer 
it, is an answer to John Daily's actual question: What is the FUNCTIONAL 
DIFFERENCE between LinuxDoc and a COMPARABLE SUBSET of DocBook tags with a 
WELL-DEFINED TOOLCHAIN? (Emphasis mine, of course.)


-- 
Rodolfo J. Paiz
####@####.####


Previous by date: 25 Nov 2003 15:06:23 -0000 wiki3 (was Re: the good the bad and the ugly), Randy Kramer
Next by date: 25 Nov 2003 15:06:23 -0000 Re: new documentation license, Rodolfo J. Paiz
Previous in thread: 25 Nov 2003 15:06:23 -0000 Re: TLDP DocBook pages need work - Start there!, David Lawyer
Next in thread: 25 Nov 2003 15:06:23 -0000 Re: TLDP DocBook pages need work - Start there!, jdd


  ©The Linux Documentation Project, 2014. Listserver maintained by dr Serge Victor on ibiblio.org servers. See current spam statz.