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] Best of practice question

Kenneth Johansson wrote:

 > When inserting tables, images do you  a) insert them inside the
 > current para or b) after the current para?

If it's part of the paragraph, then I'd do a, if it's not part of it but
instead a semantically more separate entity, then I'd do b.

 > I'm currently writing a guide for our writers and wish to have
 > everyone inserting elements the same way.

I think they should be free to choose from a and b.

 > I'm also curious about the difference of option/parameter/attribute,
 >  and why isn't there any argument element. Where I work the
 > developers either use option or argument when they are speaking
 > about "-S", "-start" or "/s" etc.

The <option>-a</option> option on the <acronym>UNIX</acronym>
<command>ls</command> command or the <option>/r</option> option on the
<acronym>DOS</acronym> <command>attrib</command>
command, for example.



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