Re: [docbook] procedure in example

[Michael Smith <smith@xml-doc.org>]

Well, I think the long-term way to solve this is to change DocBook
so that it allows procedure within example. If you agree, can you
please file a request at the following address?

  https://sourceforge.net/tracker/?func=add&group_id=21935&atid=384107

I personally think the DocBook is overly prescriptive with regard
to where it allows procedure to be used. This runs counter to one
of the fundamental design principles that DocBook has had from its
beginning: To be descriptive rather than prescriptive.

I can't see any good reason why a procedure should not be allowed
within an example.

In the mean time, I think your only solution might be to use an
orderedlist for the steps within your example. It's not ideal as
far as the source markup goes, but it should end up being rendered
the same, at least.

Hope that helps,

  --Mike

Emma Jane Hogbin <emmajane@xtrinsic.com> writes:

> Hello,
> 
> I'm trying to add a set of step-by-step instructions to an example.
> Wouldn't this be a perfect use of <procedure>? However, procedure isn't
> allowed in <example>. Does anyone have recommendations on this?
> 
> emma
> 
> -- 
> Emma Jane Hogbin
> [[ 416 417 2868 ][ www.xtrinsic.com ]]

smime.p7s