[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]