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


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

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

Subject: Re: [docbook] procedure in example

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?


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,


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 ]]


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