OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
  • 1.  MIME type for DITA - fragment identifier issue

    Posted 05-13-2008 22:20

    Hi, DITA Technical Committee:

    As I mentioned at today's meeting, the proposed MIME type for DITA [1] has one remaining issue concerning fragment identifiers -- in particular, DITA references to topic subelements because the reference contains a slash (as in "#topicID/subelementID") [2].

    To summarize the issue:

    * DITA's scheme for subelement references conforms to the basic URI requirements for fragment identifiers [3]; however
    * DITA's scheme for subelement references doesn't conform to the XPointer requirements for fragment identifiers [4]; and
    * A draft proposal would require application/*+xml MIME types to conform to XPointer requirements for fragment identifiers [5].

    To conform to XPointer, the subelement reference would likely need to be something like "#dita(topicID/subelementID)"

    We've deferred to a future version of DITA anything that would cause backward compatibility problems for existing content, and changing the fragment identifier scheme would definitely break existing references in content. So we can't do change that.

    Also, the draft proposal may never come to fruition. The current draft has expired (though that doesn't necessarily signal abandonment).

    Fundamentally, the issue comes down to a question of whether the TC wants the registered DITA MIME type to stipulate the current scheme for fragment identifiers or to pass over that issue silently.

    My feeling is that we may as well stipulate the current scheme. Implementers will need to support the current scheme anyway to conform to the DITA standard. If a future version of DITA changes the fragment identifier scheme, both adopters and tool implementers will need to deprecate the old scheme and manage a migration to the new scheme, so revising the DITA MIME type at that time to identify both old and new schemes will be useful to propagate awareness of the migration.

    Many thanks to Eliot, Jeff, and especially Paul for identifying and clarifying the issue (and supplying the expert citations).


    Hoping that's useful,


    Erik Hennum
    ehennum@us.ibm.com


    [1] Note with the most recent proposal for a DITA MIME type
    http://www.oasis-open.org/apps/org/workgroup/dita/email/archives/200805/msg00012.html
    [2] http://docs.oasis-open.org/dita/v1.1/CD02/archspec/id.html
    [3] http://www.ietf.org/rfc/rfc3986
    [4] http://www.w3.org/TR/xptr-framework/
    [5] http://www.w3.org/2006/02/son-of-3023/draft-murata-kohn-lilley-xml-02.txt



  • 2.  Re: [dita] MIME type for DITA - fragment identifier issue

    Posted 05-19-2008 02:06

    Erik Hennum <ehennum@us.ibm.com> wrote on 14/05/2008 08:18:02 AM:
    > To conform to XPointer, the subelement reference would likely need
    > to be something like "#dita(topicID/subelementID)"

    Worse, it would need to be namespaced, because unqualified scheme names are reserved for W3C recommendations [3.3 of XPointer Framework recommendation], requiring a fragment reference like
      #xmlns(dita=http://example.dita.org/)dita:dita(topicID/subelementID)
    Ick.

    It would at least not possibly clash with the existing syntax, which doesn't allow parentheses.

    I agree with Erik's gut feeling: we may as well jump on the rather large bandwagon of implementations that are ignoring XPointer.

    --
    Deborah Pickett
    Information Architect, Moldflow Pty Ltd, Melbourne
    Deborah_Pickett@moldflow.com



  • 3.  RE: [dita] MIME type for DITA - fragment identifier issue

    Posted 05-19-2008 11:18
     
    
    >