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

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-tc message

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


Subject: proposed result element


I reviewed Larry's proposal for a result element, and would like to initiate an email 
discussion.  I think the proposal is fine, and I have some comments.

1.  I think formal elements should be included in the content model of result.  I 
could easily see cases where a result would contain a table or figure that is 
significant enough to be cross referenced to from elsewhere in the document.

2.  Do we need to specify that placement of result is at the end of procedure or step? 
That seems to be a presentational feature.  I could see authoring the result at the 
beginning and then writing the steps to get to that result. Some presentation styles 
may use that order as well.

3.  I think we should allow multiple sibling result elements. In addition to Larry's 
use case to handle different procedure outcomes using a class attribute, authors may 
need to use profiling to select different results for different document conditions. 
Allowing multiple result elements makes such profiling easier.

4.  If we include a class attribute for result, do we handle it like other class 
attributes, with an enumerated list and an "otherclass" attribute?

Thanks to Larry for a thorough proposal.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net




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