Re: [dita] Archspec "linking" section

[Michael Priestley <mpriestl@ca.ibm.com>]

Check out this topic:
http://docs.oasis-open.org/dita/v1.1/OS/archspec/id.html

Michael Priestley, Senior Technical
Staff Member (STSM)
Lead IBM DITA Architect 
mpriestl@ca.ibm.com
http://dita.xml.org/blog/25

"Park Seth-R01164" <seth.park@freescale.com>

07/12/2009 12:00 PM

To	"DITA TC" <dita@lists.oasis-open.org>
cc
Subject	[dita] Archspec "linking" section

I'm reviewing the ID att section, which covers
a lot of information that should be more appropriately described in a "linking
and referencing" section as we discussed a couple of weeks ago. I
feel we need to create this topic and make a clear distinction amongst:

• The ID attribute is required to make an element eligible for link participation (and perhaps other purposes, such as search). [covered in ID attribute section][see "linking and referencing" for how ID attributes are used in linking]
• Links require a certain syntax that--in the case of targeting elements within a topic--requires a fragment identifier syntax that is non-conformant with Xpointer. [covered in "linking and referencing section]
• When a link is established, the link behavior depends on the following items... [covered in "linking and referencing section; provide the following links to appropriate sections]
  • the element that contains the link attribute (topicref/mapref have certain restrictions) [see topicref/mapref]
  • the attribute that contains the link (href vs. conref) [see href/conref]
  • conaction and conrefend attributes values (for conref only) [see conref]
  • target type (dita vs. non-dita) [see format attribute]
  • Indirect linking (keyref) enables the ability to call indirection targets (which are defined elsewhere directly) using a key string. [see keyref]
  Can we get the "linking and referencing" section in place, in a couple days?
   
  --------------------------------------------
  seth park
  information architect
  Freescale Semiconductor, Inc.
  seth.park@freescale.com
  512.895.2463