OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: Re: DOCBOOK: Re: hierarchical element reference list for docbook?

On Fri, 2 Aug 2002 ydirson@fr.alcove.com wrote:

> On Tue, Jul 30, 2002 at 03:55:41PM -0700, Norman Walsh wrote:
> > The see-also lists at the bottom of each reference page are
> > generated from this list:
> Is this list in tdg cvs, so that we could work and submit patches on
> latest version ?
> I have a couple of remarks about it:
> - the capitalization in the list is not consistent
> - the ordering of elements in each section seems near to random.  It
> would be good to put first the first elements a user is likely to
> look for.  Look at the "tables" part for an illustration.
> - there are 2 sections labelled "cross references 1"
> - I noticed a couple of elements missing (don't ask which ones, it was
> before lunch ;).  It could be worth to automatically cross-check this
> list with the DTD.

another thought.  i haven't looked at the list carefully enough to
notice, but is each element represented once and exactly once?  when
i first suggested i wanted to create a list like this, i planned on
having some elements in possibly more than once category.

for instance, a category called "inline markup" might contain the
element <computeroutput>, and another category called "computer specific
markup" might contain the same element. 

not a big deal, just an observation that sometimes a single element
can be viewed from a couple different perspectives.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC