IANA Update: Project to convert registries to XML

Michelle Cotton <michelle.cotton@icann.org> Mon, 14 July 2008 22:03 UTC

Return-Path: <ietf-bounces@ietf.org>
X-Original-To: ietf-archive@megatron.ietf.org
Delivered-To: ietfarch-ietf-archive@core3.amsl.com
Received: from [] (localhost []) by core3.amsl.com (Postfix) with ESMTP id 38F1028C353; Mon, 14 Jul 2008 15:03:44 -0700 (PDT)
X-Original-To: ietf@core3.amsl.com
Delivered-To: ietf@core3.amsl.com
Received: from localhost (localhost []) by core3.amsl.com (Postfix) with ESMTP id 5186F28C216 for <ietf@core3.amsl.com>; Mon, 14 Jul 2008 15:03:43 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.599
X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[AWL=0.000, BAYES_00=-2.599]
Received: from mail.ietf.org ([]) by localhost (core3.amsl.com []) (amavisd-new, port 10024) with ESMTP id 4atAkLX7a4Gl for <ietf@core3.amsl.com>; Mon, 14 Jul 2008 15:03:42 -0700 (PDT)
Received: from EXPFE100-2.exc.icann.org (expfe100-2.exc.icann.org []) by core3.amsl.com (Postfix) with ESMTP id 3F3BE28C317 for <ietf@ietf.org>; Mon, 14 Jul 2008 15:03:42 -0700 (PDT)
Received: from EXVPMBX100-1.exc.icann.org ([]) by EXPFE100-2.exc.icann.org ([]) with mapi; Mon, 14 Jul 2008 15:04:08 -0700
From: Michelle Cotton <michelle.cotton@icann.org>
To: IETF Discussion <ietf@ietf.org>
Date: Mon, 14 Jul 2008 15:04:07 -0700
Subject: IANA Update: Project to convert registries to XML
Thread-Topic: IANA Update: Project to convert registries to XML
Thread-Index: Acjl/YkeG3N7LFzaQUS1F8amw1WCFQ==
Message-ID: <C4A11B67.1C74E%michelle.cotton@icann.org>
Accept-Language: en-US
Content-Language: en
acceptlanguage: en-US
MIME-Version: 1.0
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Sender: ietf-bounces@ietf.org
Errors-To: ietf-bounces@ietf.org

IETF Community:

As first announced in April 2008, IANA is improving the formatting of its
protocol registries by migrating the source format of these registries to
structured XML format. We are pleased to announce the first set of migrated
registries have now come online.

Prior to this migration, typically protocol registries were formatted in a
plain text version. Now, with XML formatted source documents, IANA will
publish a number of different formats for converted registries. In
particular, converted registries will initially be available in XML, XHTML
and plain text versions.  It is intended that XHTML become the preferred
format for viewing registries, with plain text being made available for
accessibility reasons.

The remainder of the registries which are not yet converted require further
consultation on formatting issues. It is intended that over the coming
months these issues will be resolved and the conversion will be completed.
Some registries that have specific formatting requirements, such as
Management Information Base (MIB) files, will not be converted.

In order to make the transition as smooth as possible, IANA will continue to
maintain the legacy plain text formats until 30 November 2008. After this
date, plain text versions will only be provided that are derived from the
XML formats. However, implementors who intend to parse the contents of an
IANA protocol registry should migrate to using the XML versions, rather than
the plain text version.

All existing URLs to protocol registries shall continue to work, and the new
formats will be available from our website at http://www.iana.org/protocols/
as they are rolled out.

An example of a converted registry is:
http://www.iana.org/assignments/aaa-parameters (legacy text version)
http://www.iana.org/assignments/aaa-parameters/aaa-parameters.txt (new text
http://www.iana.org/assignments/aaa-parameters/aaa-parameters.xhtml (new
HTML version)
http://www.iana.org/assignments/aaa-parameters/aaa-parameters.xml (new XML

The next steps (in addition to completing the remaining registries) includes
introducing new services such as the ability to subscribe to be notified of
registry changes. IANA will continue to provide updates to the IETF list as
more steps are completed.

If you have any questions regarding this project or regarding the format of
the registries, please contact IANA (iana@iana.org) or myself (contact
information found below).

Thank you,

Michelle Cotton
Email: michelle.cotton@icann.org


Initial Announcement:  Wed, 23 Apr 2008
Subject: IANA Update: Project to convert registries to XML

IANA is currently engaged in a project to convert the IETF related
registries to XML to provide the community with multiple ways of
viewing registry information.  When conversion to XML is done, XML
will become the source format for the registries and the current
formats of html and plain text will be generated from the XML
source.  Stylesheets and schemas will also be made available together
with XML. Users will be able to access the registries in new and
useful ways, while still having the ability to see the registries in
the original style.

Part of the conversion requires IANA to "clean-up" the registries in
order to fit with the XML schemas.  IANA is not changing the data in
the registries.  IANA is cleaning up the formatting including
regularizing spacing and providing consistent display of titles,
references and registration procedures.

For those registries that need extensive format changes, IANA will be
working with the appropriate working groups and area directors to
make sure that the format changes do not affect the content of the

Those registries that are required to be in specific formats, for
example the MIBs and language subtags registries, will still be
produced in the existing formats.

IANA has consulted with the IETF XML directorate to make sure that
the XML schemas are properly formulated. Certain decisions on schemas
reflect the needs of IANA in maintaining the registries moving forward.

In the coming months, cleaned-up versions of the registries will
begin appearing on the IANA website.  If you notice any content
issues with the updated versions, or if they are not accessible,
please notify IANA staff immediately and we will work with the
appropriate parties to correct any inconsistencies.

We look forward to providing the XML versions of the registries to
better serve the community's needs.  IANA will announce in advance when
the registry conversion will be completed.  After the
conversion is complete, we intend to introduce new services such as
the ability to subscribe to be notified when specific registries are

Thank you,

Michelle Cotton
Email: michelle.cotton@icann.org

Ietf mailing list