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.



512.895.2463