This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Usage Question



Hello fellow Docbook users!
	
Sun Microsystems has proposed a change to the Docbook DTD which would 
allow additional material after the last step in a procedure. Specifically,
the writers have a need for a Titled Section within Procedure after any
Steps--which is useful for related "Examples" as well as "Where to go 
from Here" or "See Also" information. 
	
Because this Section should have structure but an end point in the 
Section heirarchy, we'd like to use SimpleSect. and extend the content
model of Procedure to include it.
	
We have internal requirements which don't allow us to include optional 
Titles, and that's why Bridgehead doesn't quite work.
	
We can't use Example because authors may reference other sort of information,
as is mentioned above.
	
The work around previously has been to use Sect2 and mark up the "See Also"
information as a Sect3. An attribute value of "procedure" is also set for 
role. This is rather inelegant and encourages authors to always use a 
Sect2 element instead of Procedure.
	
Does anyone else in the user community have similar requirements, and 
if so, what do you do? Any comments or discussion is appreciated!
	
thanks!
Sabine-
	
	
	Sabine Ocker 
	Sun Microsystems, Inc. 
	1 Network Drive Burlington, MA 01803 
	Mailstop BUR02 - 201 
	Phone : 781-442-3538
	Fax   : 781-442-1437 
	Web   : http://www.sun.com 
	Email : sabine.ocker@East.Sun.COM 
		
	

Sabine Ocker 
Sun Microsystems, Inc. 
1 Network Drive Burlington, MA 01803 
Mailstop BUR02 - 201 
Phone : 781-442-3538
Fax   : 781-442-1437 
Web   : http://www.sun.com 
Email : sabine.ocker@East.Sun.COM 
	


------------------------------------------------------------------
To unsubscribe from this elist send a message with the single word
"unsubscribe" in the body to: docbook-request@lists.oasis-open.org


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]