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

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

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


Subject: RE: [dita] What Is A Topic


I am about to start a new project for a client that has a lot of legacy API
docs that they want converted to DITA. Since I wrote some of these docs I
know there are many places where reuse can be effective. 

The areas for reuse involves things like parameter descriptions and certain
use notes. Neither of these would conventionally be thought of as topics. In
DITA would it be best to treat them as topics even though some would not
have a title.

Rob
-----Original Message-----
From: W. Eliot Kimber [mailto:ekimber@innodata-isogen.com] 
Sent: Thursday, December 21, 2006 8:57 AM
To: dita@lists.oasis-open.org
Subject: Re: [dita] What Is A Topic

Michael Priestley wrote:

> On the issue of title-only topics in particular I wanted to add a few 
> things:
> 
> - a small topic may legitimately need only a title and short description 
> - our own glossentry specialization comes to mind. Some forms of 
> context-sensitive help are also likely to be very short, and with the 
> addition of abstract, easily accomodated without the <body> element.

<snip>



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