← Prev in month
← Prev in thread
Next in thread →
Next in month →
DocBook TC teleconference Agenda Item 5.
Hello Everyone!
In preparation for tomorrow's telconference, below is a brief
writeup of the discussion points for Agenda Item 5.4:
RFE145 Allow additional material after the last step in a Procedure
Which was submitted by Sun Microsystems.
regards,
Dennis Evans
Sabine Ocker
Reasons for request:
- This change will allow titled sections within Procedures
following the Steps. This is useful for related Examples,
Where to go from Here info, etc.
- It provides structure (content and title), but is not intended
to be a major element. The intention is that this is an end
point, you cannot go anywhere else from here in the hierarchy.
This section should not contain any other titled material.
Requirements:
- Does not need to be in TOC
- Can be xrefed
- Can have conditional gentext or display based on
attributes such as arch
Content model being approximately:
<!ELEMENT Procedure - - (
(Title, TitleAbbrev?)?, (%component.mix),
step+, SimpleSect?)
Sample of how we work around it now:
<sect1>
<title>Creating Concatenations</title>
<para>Do not use this procedure on an existing file system or
data.</para>
<sect2 role="procedure">
<title>How to Create a Concatenation</title>
<procedure>
<step>
<para>Check the prerequisites (<xref linkend="addtasks-20933">)
and the preliminary information.</para>
</step>
<step>
<para>To create the concatenation from the Solaris Management
Console</para>
</step>
<step>
<para>To create the concatenation from the command line, use the
following form of the metainit command:</para>
</step>
</procedure>
<sect3>
<title>Where To Go From Here</title>
<para>Information for the IA archtecture is different.</para>
</sect3>
</sect2>
</sect1>
Sample of how we want to do it:
<sect1>
<title>Creating Concatenations</title>
<para>Do not use this procedure on an existing file system or
data.</para>
<procedure>
<title>How to Create a Concatenation</title>
<procedure>
<step>
<para>Check the prerequisites (<xref linkend="addtasks-20933">)
and the preliminary information.</para>
</step>
<step>
<para>To create the concatenation from the Solaris Management
Console</para>
</step>
<step>
<para>To create the concatenation from the command line, use the
following form of the metainit command:</para>
</step>
<simplesect>
<title>Where To Go From Here</title>
<para>Information for the IA archtecture is different.</para>
</simplesect>
</procedure>
</sect2>
</sect1>
← Prev in month
← Prev in thread
Next in thread →
Next in month →