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


Help: OASIS Mailing Lists Help | MarkMail Help

dita-busdocs message

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

Subject: Re: [dita-busdocs] Groups - Designing DITA Abstract Topic Types.pptuploaded


I have a concern with specializing shortdesc for rule/etc.  While I 
fully support the idea of capturing the key information about the topic 
in a shortdesc-like element, I am uneasy with using shortdesc as it has 
a dual purpose.    In addition to being the "initial paragraph-like 
content of a topic," it is also "intended to be used as the link preview 
for searching.   The content you might capture as a rule, might not 
actually be effective as a link-teaser.  As an alternative, could the 
initial paragraph (like rule) element be specialized off abstract 
instead?  That way, you could have both rule and shortdesc in a topic 
and ensure they are appropriate to their individual uses.


07/06/2010 11:18 AM, tgrantham@timgrantham.com wrote:
> Here it is, with corrections for typos.
>   -- Tim Grantham
> The document named Designing DITA Abstract Topic Types.ppt has been
> submitted by Tim Grantham to the DITA Enterprise Business Documents SC
> document repository.
> Document Description:
> Proposes a set of practices for designing abstract topic types
> View Document Details:
> http://www.oasis-open.org/committees/document.php?document_id=38147
> Download Document:
> http://www.oasis-open.org/committees/download.php/38147/Designing%20DITA%20Abstract%20Topic%20Types.ppt
> PLEASE NOTE:  If the above links do not work for you, your email application
> may be breaking the link into two pieces.  You may be able to copy and paste
> the entire link address into the address field of your web browser.
> -OASIS Open Administration

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