OASIS Darwin Information Typing Architecture (DITA) TC

 View Only

RE: [dita] Book title in bookmap

  • 1.  RE: [dita] Book title in bookmap

    Posted 04-10-2006 20:27
     MHonArc v2.5.0b2 -->
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    dita message

    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


    Subject: RE: [dita] Book title in bookmap


    I have to account for dependency issues in the bookmap proposal for the
    "design complete" consideration.  Moving translateable attributes into
    elements is an accepted goal for  DITA 1.2.  Since our 1.1 work includes
    assessing other contingent proposals for completeness, I agree with the
    suggestion to include just the map/title element proposal as part of DITA
    1.1 so that bookmap can properly include this contingent change in its
    complete proposal.
    
    Regards,
    --
    Don Day
    Chair, OASIS DITA Technical Committee
    IBM Lead DITA Architect
    Email: dond@us.ibm.com
    11501 Burnet Rd. MS9033E015, Austin TX 78758
    Phone: +1 512-838-8550
    T/L: 678-8550
    
    "Where is the wisdom we have lost in knowledge?
     Where is the knowledge we have lost in information?"
       --T.S. Eliot
    
    
                                                                               
                 "Gershon L                                                    
                 Joseph"                                                       
                 <gershon@tech-tav                                          To 
                 .com>                     <gershon@tech-tav.com>, "'Farwell,  
                                           Kevin'"                             
                 04/09/2006 09:17          <Kevin.Farwell@lionbridge.com>,     
                 AM                        Robert D                            
                                           Anderson/Rochester/IBM@IBMUS,       
                                           <dita@lists.oasis-open.org>         
                 Please respond to                                          cc 
                 <gershon@tech-tav                                             
                       .com>                                           Subject 
                                           RE: [dita] Book title in bookmap    
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
    
    
    
    
    Hmf, reading further down the thread I see I answered in the middle... My
    take is let's do the minimum now to get bookmap working in 1.1, and move
    translatable attributes to elements in 1.2.
    
    
    Best Regards,
    Gershon
    
    
    -----Original Message-----
    From: Gershon L Joseph [mailto:gershon@tech-tav.com]
    Sent: Sunday, April 09, 2006 4:42 PM
    To: 'Farwell, Kevin'; 'Robert D Anderson'; dita@lists.oasis-open.org
    Subject: RE: [dita] Book title in bookmap
    
    Since we want to minimize the changes needed for 1.1, I also vote for
    option
    1. Having elements for the map titles will also bring joy to those who
    convert non-DITA XML documents to DITA (since the title attributes in the
    map often inherit characters and markup that's not valid in XML
    attributes).
    
    
    Best Regards,
    Gershon
    
    
    -----Original Message-----
    From: Farwell, Kevin [mailto:Kevin.Farwell@lionbridge.com]
    Sent: Wednesday, April 05, 2006 6:36 PM
    To: Robert D Anderson; dita@lists.oasis-open.org
    Subject: RE: [dita] Book title in bookmap
    
    Hello,
    
    I'd vote for option 1. I'm not in favor of having any translatable content
    in the book map. That just makes one more file to translate, one more place
    to manage terminology, one more file to version, and one more place
    mistakes
    can be made. If the book file is only a collection of references to
    external
    content, the efficiency of the map is preserved.
    
    
    The conflict is unavoidable. People using book maps now, with their titles
    in attributes, will have to rework their files either way.
    
    Kevin
    
    -----Original Message-----
    From: Robert D Anderson [mailto:robander@us.ibm.com]
    Sent: Monday, April 03, 2006 2:09 PM
    To: dita@lists.oasis-open.org
    Subject: [dita] Book title in bookmap
    
    
    Don and I were working on the bookmap DTD, and ran in to a problem. When we
    originally put the proposal together, we were planning for one large
    release
    rather than the current 1.1 and 1.2 releases. As part of the design, we
    counted on proposed feature number 11, which had already been
    approved:
    http://www.oasis-open.org/committees/download.php/13734/IssueNumber11.ht
    ml
    
    This is the proposal to make translatable attributes into elements. One of
    the items in that proposal is to add a <title> element to map, to be used
    instead of the title attribute. The book model really needs this title
    element in order to allow for more structured book titles, such as title +
    library information. Unfortunately, feature #11 was moved to 1.2, so it
    will
    not be released with bookmap. I see three possibilities:
    1. We force the title into the bookmeta element. This could work, but will
    cause conflicts with the title element once 1.2 is released (and bookmap is
    updated for the change).
    2. We do that one part of #11 in 1.1 -- we just allow the title element
    inside map. Leave the others for 1.2.
    3. We let the 1.1 scope creep to include all of #11
    
    I would vote for #2 - the partial implementation that brings the title
    element into maps. Any other thoughts?
    
    Robert D Anderson
    IBM Authoring Tools Development
    Chief Architect, DITA Open Toolkit
    (507) 253-8787, T/L 553-8787
    
    
    
    
    
    
    
    
    
    


    [Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]