-------------------------------------------------------------------
APNIC Document identity

 Title:       APNIC Document editorial policy
 
 Short title: 			  doc-editorial-policy
 Document ref:                    APNIC-112
 Version:                         001
 Date of original publication:    19 February 2004
 Date of current version:         19 February 2004
 Review scheduled:                n/a
 Obsoletes:                       APNIC-083
 Status:                          Active
 Comments:                        n/a
--------------------------------------------------------------------


APNIC Document editorial policy



Table of contents
-----------------

       1	Introduction

       2	Scope

       3	Definitions

       3.1	Official Documents
       3.2	Document review

       4	Language
       4.1	Official language
       4.2	Translated documents

       5	Document review procedure

       Step 1: Call for comments
       Step 2: Incorporating comments
       Step 3: Implementing documents

       6	Publication format

       7	Labeling documents




1	Introduction
--------------------

This document describes the editorial process used by the APNIC
Secretariat to document and implement consensus decisions arising
from the "APNIC Policy Development Process" (policy-development-
draft)
and to maintain clear, effective, and up-to-date documentation.



2	Scope
-------------

This document describes the policies and procedures that apply to
the production and maintenance of APNIC official documents. It
relates to the development, revision, translation, accessibility,
and archiving of these official documents.



3	Definitions
-------------------

3.1	Official Documents

Official documents are documents created by APNIC to describe:

       * policies;
       * membership rights and obligations; and
       * legal relationships.

Documents that are not official documents for these purposes
include:

       * reports, proposals, and presentations;
       * brochures and similar informational materials;
       * forms; and
       * general web site content

3.2	Document review

In this document, "document review" refers to the process of
creating, developing, or revising official documents.



4	Language
----------------

4.1	Official language

To provide the fairest possible access to APNIC information
and resources across the entire region, all official APNIC
documents will be published in English.

4.2	Translated documents

APNIC allocates resources from each annual budget for the
translation of documents into other languages of the region
(although it may not be possible to translate all documents,
or to translate into all languages of the region).

Regardless of any translations made, the English language
version published by APNIC will remain the official document.



5	Document review procedure
---------------------------------

The APNIC Secretariat will start a document review to:

       * Implement a consensus decision arising from the Policy
         Review Process (which may require either the creation of a
         new document, or the amendment of an existing document);
         or

       * Correct errors in, or improve the wording, formatting, or
         presentation of an existing document.

Document reviews will follow the steps outlined below.


Step 1:	Call for comments

The APNIC Secretariat will release a public draft of the document
and issue a call for comments by making an announcement on relevant
mailing lists and posting a notice on the APNIC website. The
comment period will be one month.

Interested parties may:

       * object to the draft document on the grounds that it does
         not properly reflect the consensus decision reached in the
         Policy Review Process;
       * suggest improvements of any aspect of the document;
       * request that an additional call for comment be made to
         allow more consideration of substantial revisions.


Step 2:	Incorporating comments

The APNIC Secretariat will consider all comments received and will
produce a final version of the document. The APNIC Secretariat may
also determine whether the comments received justify an additional
comment period.


Step 3:	Implementing documents

When Steps 1 and 2 have been completed, the APNIC Secretariat will
publish the final version as an official document.



6	Publication format
--------------------------

Official documents will, in most cases, be published in text (.txt)
and HTML file formats. HTML documents may differ from the text
versions by way of the inclusion of hyperlinks, formatting, and
graphics; however, in case of any differences in content, the text
version will be considered to be the official document.

In some cases, particular layout requirements may require that the
official document is published in Portable Document Format (.pdf)
or similar format.



7	Labeling documents
--------------------------

Official documents will be labeled with the following information:

       * document name;
       * APNIC document reference number;
       * date of original publication;
       * date of publication of current version;
       * scheduled date for next review, if applicable;
       * list of any documents obsoleted by implementation.

In addition, if an official document has been obsoleted, the
labeling of the document will identify the document that obsoleted
it and the date it was obsoleted.