<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE rfc SYSTEM "http://xml.resource.org/authoring/rfc2629.dtd" [
  <!ENTITY rfc3986 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.3986.xml">
  <!ENTITY rfc5226 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.5226.xml">
  <!ENTITY rfc6906 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.6906.xml">
  <!ENTITY jsonld SYSTEM "http://xml.resource.org/public/rfc/bibxml4/reference.W3C.CR-json-ld-20130910.xml">
]>

<?xml-stylesheet type="text/xsl" href="../rfc2629.xslt" ?>
<?rfc compact="yes" ?>
<?rfc subcompact="no" ?>
<?rfc toc="yes" ?>
<?rfc sortrefs="yes" ?>
<?rfc symrefs="yes" ?>
<rfc category="info" ipr="trust200902" docName="draft-lanthaler-profile-registry-03">
  <front>
    <title abbrev="Profile URI Registry">The IETF Profile URI Registry</title>
    <author initials="M." surname="Lanthaler" fullname="Markus Lanthaler">
      <address>
        <email>mail@markus-lanthaler.com</email>
        <uri>http://www.markus-lanthaler.com/</uri>
      </address>
    </author>
    <date day="17" month="September" year="2013" />
    <keyword>profile</keyword>
    <keyword>urn</keyword>
    <abstract>
      <t>This document defines a registry for profile URIs to be used in
        specifications standardizing profiles.</t>
    </abstract>
  </front>
  <middle>
    <section title="Introduction">
      <t>Profiles, as defined by <xref target="RFC6906" />, can be used to
        signal support for additional semantics, such as constraints,
        conventions, extensions, or any other aspects that do not alter the
        basic media type semantics. Profiles are identified by a URI and
        can thus be created without central coordination.</t>

      <t>Similarly to media types and link relation types it is, in some cases,
        beneficial to centrally manage profile URIs to ensure interoperability
        and decrease the coupling between clients and servers. This allows the
        independent evolution of clients and servers as both are coupled to
        these central contracts instead of being coupled to each other.
        Therefore, this document establishes an IANA registry for profile
        URIs.</t>
    </section>

    <section title="Registration Process" anchor="registration-process">
      <t>All elements in this registry require a URI in order to be
        registered. The meaning of the profile URI must be documented
        in a permanent and readily available public specification in
        sufficient detail so that interoperability between independent
        implementations is possible ("Specification Required" per
        <xref target="RFC5226" />).</t>

      <t>An exemplary registration request can be found in
        <xref target="example-reg-req" />.</t>
    </section>

    <section title="Example Registration Request" anchor="example-reg-req">
      <t>The following is an example registration request for the profile
        URI http://example.com/profiles/example.</t>

      <t><vspace blankLines="1" /></t>

      <t>This is a request to IANA to please register the profile URI
        "http://example.com/profiles/example" in the Profile URI Registry
        according [this document].</t>

      <t>
        <list style="symbols">
          <t>Profile URI: http://example.com/profiles/example</t>
          <t>Common Name: Exemplary Profile URI</t>
          <t>Description: An exemplary profile URI registration.</t>
          <t>Specification Document: [this document]</t>
        </list>
      </t>
    </section>

    <section title="IANA Considerations">
      <t>This document establishes the Profile URI registry. The
        registration procedure for new entries requires a request in
        the form of the following template and is "Specification
        Required" per <xref target="RFC5226" />. Instructions
        for a registrant to request the registration of a profile URI are
        in <xref target="registration-process" />.</t>

      <t>The underlying registry data (e.g., the XML file) must include
        Simplified BSD License text as described in Section 4.e
        of the Trust Legal Provisions
        (<eref target="http://trustee.ietf.org/license-info" />).</t>

      <t>The registration template is:</t>

      <t>
        <list style="symbols">
          <t>Profile URI: The URI that identifies the registered
            profile.</t>
          <t>Common Name: The name by which the profile being registered
            is generally known.</t>
          <t>Description: A short description of the profile</t>
          <t>Specification Document:  Reference to the document that
            specifies the URI, preferably including a URI that can be
            used to retrieve a copy of the document. An indication of
            the relevant sections may also be included but is not
            required.</t>
          <t>Notes: [optional]</t>
        </list>
      </t>

      <section title="Initial Registry Contents">
        <t>The Profile URI registry's initial contents are:</t>

        <?rfc subcompact="yes" ?>

        <t>
          <list style="symbols">
            <t>Profile URI: urn:example:profile-uri</t>
            <t>Common Name: Exemplary Profile</t>
            <t>Description: A profile to be used in examples.</t>
            <t>Specification Document: [this document]</t>
          </list>
        </t>

        <t>
          <list style="symbols">
            <t>Profile URI: http://dublincore.org/documents/2008/08/04/dc-html/</t>
            <t>Common Name: Dublin Core HTML meta data profile</t>
            <t>Description: A set of conventions by which a Dublin Core
              metadata description set can be can be represented within an
              (X)HTML Web page using (X)HTML elements and attributes.</t>
            <t>Specification Document: <xref target="DC-HTML" /></t>
          </list>
        </t>

        <t><vspace blankLines="2" /></t>

        <t>
          <list style="symbols">
            <t>Profile URI: http://www.w3.org/ns/json-ld#expanded</t>
            <t>Common Name: Expanded JSON-LD</t>
            <t>Description: A profile URI to request or signal expanded
              JSON-LD document form.</t>
            <t>Specification Document: <xref target="W3C.CR-json-ld-20130910" /></t>
          </list>
        </t>

        <t>
          <list style="symbols">
            <t>Profile URI: http://www.w3.org/ns/json-ld#compacted</t>
            <t>Common Name: Compacted JSON-LD</t>
            <t>Description: A profile URI to request or signal compacted
              JSON-LD document form.</t>
            <t>Specification Document: <xref target="W3C.CR-json-ld-20130910" /></t>
          </list>
        </t>

        <t>
          <list style="symbols">
            <t>Profile URI: http://www.w3.org/ns/json-ld#flattened</t>
            <t>Common Name: Flattened JSON-LD</t>
            <t>Description: A profile URI to request or signal flattened
              JSON-LD document form.</t>
            <t>Specification Document: <xref target="W3C.CR-json-ld-20130910" /></t>
          </list>
        </t>

        <?rfc subcompact="no" ?>

      </section>
    </section>

    <section title="Security Considerations">
      <t>There are no additional security considerations beyond those
        already inherent to using URIs. Security considerations for URIs
        in general can be found in <xref target="RFC3986" />.</t>
    </section>

    <section title="Change Log">
      <t>Note to RFC Editor: Please remove this section before publication.</t>
      <section title="From -02 to -03">
        <t>
          <list style="symbols">
            <t>Seed registry with the profile URIs defined in
              <xref target="DC-HTML" /> and <xref target="W3C.CR-json-ld-20130910" />.</t>
          </list>
        </t>
      </section>
      <section title="From -01 to -02">
        <t>
          <list style="symbols">
            <t>Do not establish a new IETF URN Sub-namespace anymore.</t>
          </list>
        </t>
      </section>
      <section title="From -00 to -01">
        <t>
          <list style="symbols">
            <t>Use HTTP URI instead of URN in example registration request
              to make it clearer that not only URNs can be registered.</t>
            <t>Move security considerations to the end.</t>
          </list>
        </t>
      </section>
    </section>

    <section title="Acknowledgements">
       <t>Thanks to Dave Cridland for valuable comments and suggestions.</t>
    </section>
  </middle>
  <back>
    <references title="Normative References">
      &rfc3986;
      &rfc5226;
      &rfc6906;
      &jsonld;

      <reference anchor="DC-HTML" target="http://dublincore.org/documents/2008/08/04/dc-html/">
        <front>
          <title>Expressing Dublin Core metadata using HTML/XHTML meta and link elements</title>
          <author initials="P." surname="Johnston" fullname="Pete Johnston">
            <organization>Eduserv Foundation</organization>
            <address>
              <email>pete.johnston@eduserv.org.uk</email>
            </address>
          </author>
          <author initials="A." surname="Powell" fullname="Andy Powell">
            <organization>Eduserv Foundation</organization>
            <address>
              <email>andy.powell@eduserv.org.uk</email>
            </address>
          </author>
          <date month="August" year="2008"/>
        </front>
        <seriesInfo name="Dublin Core Metadata Initiative" value=""/>
      </reference>
    </references>
  </back>
</rfc>
