[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. rday
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Powered by eList eXpress LLC