[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Subject: DOCBOOK: 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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Powered by eList eXpress LLC