OASIS Open Document Format for Office Applications (OpenDocument) TC

  • 1.  ISO formatting rules

    Posted 11-28-2007 20:41 

    Just following up on an action item.

    ISO/IEC Directives, Part 2 "Rules
for the structure and drafting of international standards" is the
style guideline we'll need to follow in ODF 1.2.  Under PAS submission
rules, our first submission did not need to adhere to these rules, but
subsequent submissions are not excepted.

    It can be downloaded from here:  http://www.iec.ch/tiss/iec/Directives-Part2-Ed5.pdf

    In particular, note the following:

    -- Section 5.2 has important info on
how clauses are numbered, and why things like "hanging paragraphs"
are deprecated.
    -- Annex H "Verbal forms for the
expression of provisions" has the rules for using "shall",
"shall not", etc.
    -- Annex I should be looked at for OpenFormula
for whenever we refer to units of measurement, such as the CONVERT() function

    If you have any questions, ask Patrick
 ;-)

    -Rob
    _________________________

    
Rob Weir
    
Software Architect
    
Workplace, Portal and Collaboration Software
    
IBM Software Group

    
email: robert_weir@us.ibm.com
    
phone: 1-978-399-7122
    
blog:     http://www.robweir.com/blog/


  • 2.  Re: [office] ISO formatting rules

    Posted 11-28-2007 21:21 
    Rob,

robert_weir@us.ibm.com wrote:
>
> Just following up on an action item.
>
> ISO/IEC Directives, Part 2 "Rules for the structure and drafting of 
> international standards" is the style guideline we'll need to follow 
> in ODF 1.2.  Under PAS submission rules, our first submission did not 
> need to adhere to these rules, but subsequent submissions are not 
> excepted.
>
> It can be downloaded from here: 
>  http://www.iec.ch/tiss/iec/Directives-Part2-Ed5.pdf
>
> In particular, note the following:
>
> -- Section 5.2 has important info on how clauses are numbered, and why 
> things like "hanging paragraphs" are deprecated.
> -- Annex H "Verbal forms for the expression of provisions" has the 
> rules for using "shall", "shall not", etc.
> -- Annex I should be looked at for OpenFormula for whenever we refer 
> to units of measurement, such as the CONVERT() function
>
> If you have any questions, ask Patrick  ;-)
>
Gee, thanks! ;-)

Actually the less I have to change editorially the quicker the work will go.

BTW, I got word from ISO today that "draw:page 9.2.4.8" is an acceptable 
cross reference. In a listing of cross references there is no need to 
have "See/see" or even parens around the reference (in a listing of 
references). Still need the parens in a sentence were the name is not 
explicitly used. We distinguish the cross references by style anyway and 
the "See/see," the usual "-" and parens are legacy formatting practices.

That may not sound like much but when you consider that ODF 1.2 will 
have literally thousands of cross references it starts to make a real 
difference both in terms of the presentation as well as in recording the 
references.

Hope you are having a great day!

Patrick
> -Rob
> _________________________
>
> Rob Weir
> Software Architect
> Workplace, Portal and Collaboration Software
> IBM Software Group
>
> email: robert_weir@us.ibm.com
> phone: 1-978-399-7122
> blog: http://www.robweir.com/blog/ 

-- 
Patrick Durusau
patrick@durusau.net
Chair, V1 - US TAG to JTC 1/SC 34
Acting Convener, JTC 1/SC 34/WG 3 (Topic Maps)
Co-Editor, ISO/IEC 13250-1, 13250-5 (Topic Maps)
Co-Editor, OpenDocument Format (OASIS, ISO/IEC 26300)


Related Content