Re: interface tag

[Sander Vesik <Sander Vesik Sun COM>]

On Tue, 11 Jun 2002, Eric Baudais wrote:

> Sasha-
> 
> My point is that you do not know if you will want the standard interface 
> terms altered by the stylesheets in any way.  Right now they aren't being 
> altered, but that could change in the future.  Maybe we wanted to have all 
> the interface terms added to links to a glossary by the appropriate 
> definition.  This could be done using a XSL stylesheet and would be hard to do
> any other way.  If all the standard interface terms were marked up adding 
> the link would be trivial with the stylesheet.
> 
> However, I do think there is a point where the documenter can mark up too 
> many words.  I'm not sure where this line can be drawn though.  Obviously 
> marking up GNOME and XML every time with the <acronym> tag is pointless, but 
> can the same be said for marking up standard interface terms.  My opinion is 
> these need to be marked up.
>

Not all markup needs to be visualy differenciatable to be useful - if all
acronyms were marked up at least once  in the documents (say when
introduced or similar) it would allow you to extract a list that could
then say be compared against the glossary to check which were covered. You
could also index covered terms (even if only on the 'which manuals this is
in' basis) and so on. But I agree that always marking up every instance of
everything would be excessive.
 
> Eric Baudais
> 
	Sander

	you'll rescue me right?
	in the exact same way that they never did
	i'll be happy right?
	when your healing powers kick in