$Id: wd-spectools-instructions.xml,v 1.3 2003/02/14 19:16:23 ndw Exp $
wd-spectools-instructions
02
HTML
XML
PDF
http://www.oasis-open.org/spectools/docs
Specification Template Instructions
WalshNorman
Norman.Walsh@Sun.COM
MalerEve
Eve.Maler@Sun.COM
KarlBest
OASIS
14 Feb 2003
20022003
OASIS Open, Inc. All Rights Reserved.
This document lays out the recommended best practices for
writing OASIS standards-track documents in DocBook, Office
applications, and XHTML.
Status
This is a Working Draft.
If you have comments about this document, please send them to
Eve Maler Eve.Maler@Sun.COM and
Norman Walsh Norman.Walsh@Sun.COM.
Introduction
This document lays out the recommended best practices for
writing OASIS standards-track documents in DocBook,
Office
applications, and XHTML.
This document is an instance of itself, that is to say, the XML
source for this document is in DocBook and satisfies the
recommendations specified herein.
Terminology
The key words must, must
not, required,
shall, shall not,
should, should not,
recommended, may, and
optional in this document are to be
interpreted as described in .
Some specifications may choose to capitalize these words, or use
other typographic conventions to make them stand out and to separate
their use in a normative sense from their use in a natural-language
sense. This document does not.
DocBook Specifications
TBD
See the DocBook template for more information.
Office Specifications
TBD
See the Microsoft Word and
Star Office templates for more information.
Styling OASIS Standards
OASIS standards-track documents encoded in DocBook can be styled with an
processor to produce HTML or versions.
The HTML versions are styled by the appropriate OASIS CSS stylesheet.
The XSL versions can subsequently be styled with an XSL Formatter to produce
and other hardcopy formats.
OASIS standards-track documents encoded in Office
applications are styled by the appropriate OASIS template.
OASIS standards-track documents encoded in XHTML
are styled by the appropriate OASIS CSS stylesheet.
OASIS Specification Tools
The following individuals helped in
the formulation of this document:
Karl Best, OASIS
Eve Maler, Sun Microsystems
Norman Walsh, Sun Microsystems
Notices
Copyright © 2002, 2003 OASIS Open, Inc. All Rights Reserved.
OASIS takes no position regarding the validity
or scope of any intellectual property or other rights
that might be claimed to pertain to the implementation
or use of the technology described in this document
or the extent to which any license under such rights
might or might not be available; neither does it represent
that it has made any effort to identify any such rights.
Information on OASIS's procedures with respect to rights
in OASIS specifications can be found at the OASIS website.
Copies of claims of rights made available for publication
and any assurances of licenses to be made available,
or the result of an attempt made to obtain a general
license or permission for the use of such proprietary
rights by implementors or users of this specification,
can be obtained from the OASIS Executive Director.
OASIS invites any interested party to bring to
its attention any copyrights, patents or patent applications,
or other proprietary rights which may cover technology
that may be required to implement this specification.
Please address the information to the OASIS Executive
Director.
This document and translations of it may be copied
and furnished to others, and derivative works that comment
on or otherwise explain it or assist in its implementation
may be prepared, copied, published and distributed,
in whole or in part, without restriction of any kind,
provided that the above copyright notice and this paragraph
are included on all such copies and derivative works.
However, this document itself may not be modified in
any way, such as by removing the copyright notice or
references to OASIS, except as needed for the purpose
of developing OASIS specifications, in which case the
procedures for copyrights defined in the OASIS Intellectual
Property Rights document must be followed, or as required
to translate it into languages other than English.
The limited permissions granted above are perpetual
and will not be revoked by OASIS or its successors or
assigns.
This document and the information contained herein
is provided on an AS IS
basis and OASIS DISCLAIMS
ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES
OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
OASIS has been notified of intellectual property
rights claimed in regard to some or all of the contents
of this specification. For more information consult
the online list of claimed rights.
Revision History
02
14 Feb 2003
ndw
Updated copyright notices; reformatted
with the correct OASIS logo.
01
26 Apr 2002
ndw
Initial publication.
References
Normative
Non-Normative