OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

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


Subject: RE: [dita] Name attribute of object element


Did we ever make any progress on this? I would still like to see some
public list of minor editorial and technical issues to be worked out.
This will become even more urgent as we try to merge in a bunch of new
content and that content itself contains issues to be worked out.

> -----Original Message-----
> From: Don Day [mailto:dond@us.ibm.com] 
> Sent: Thursday, January 05, 2006 9:51 AM
> To: JoAnn.Hackos@Comtech-Serv.com; Michael Priestley
> Cc: dita@lists.oasis-open.org; Paul Prescod; Su-Laine Yeo
> Subject: RE: [dita] Name attribute of object element
> 
> Michael is out of the office this week, JoAnn.  I'm confident 
> that if we start a log format on the Wiki, that he would want 
> to transfer any of his existing record-keeping to that 
> publicly-accessible page, and I would help him if necessary.  
> The larger action item would be for someone to review our 
> records for previously uncaptured mentions of bugs or updates.
> 
> Did you have a format in mind?  I thought that we might 
> structure the bug log area as if it were a reference topic, 
> using a titled section equivalent to indicate each subject 
> deliverable (1.0 arch spec, 1.0 lang spec, 1.0 DTDs/Schemas, 
> etc.), and a simpletable equivalent in each as the log form, 
> with columns for:
> 
> assigned issue #
> commenter
>   reported issue/date
> owner
>   initial response
>   notes
>   resolution/date
>   pointers to drafts, correspondence, new content, etc..
> 
> Any additions or comments on this proposed log design?  We 
> can confirm the design during our TC discussion about the Wiki.
> 
> 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
> 
> 
>                                                               
>              
>              "JoAnn Hackos"                                   
>              
>              <joann.hackos@com                                
>              
>              tech-serv.com>                                   
>           To 
>                                        "Paul Prescod"         
>              
>              01/05/2006 10:59          
> <paul.prescod@blastradius.com>, Don 
>              AM                        Day/Austin/IBM@IBMUS   
>              
>                                                               
>           cc 
>                                        
> <dita@lists.oasis-open.org>,        
>                                        "Su-Laine Yeo"         
>              
>                                        
> <su-laine.yeo@blastradius.com>      
>                                                               
>      Subject 
>                                        RE: [dita] Name 
> attribute of object 
>                                        element                
>              
>                                                               
>              
>                                                               
>              
>                                                               
>              
>                                                               
>              
>                                                               
>              
>                                                               
>              
> 
> 
> 
> 
> I'd like to see a log for required changes to the 
> specification. Is Michael already putting this together?
> JoAnn
> 
> -----Original Message-----
> From: Paul Prescod [mailto:paul.prescod@blastradius.com]
> Sent: Thursday, January 05, 2006 8:16 AM
> To: Don Day
> Cc: dita@lists.oasis-open.org; Su-Laine Yeo
> Subject: RE: [dita] Name attribute of object element
> 
> Attributes like "tabindex" and "name" should be removed if 
> they do not fit into a larger DITA context that makes sense. 
> For example, with "name" the description is "Submit the 
> object as part of a form." But DITA has no forms capability 
> and no way to make the form that would surround the object. 
> So it seems to me that this attribute has no use case 
> whatsoever. The same holds for tabindex, which I believe is 
> also only relevant in a forms context. I am also not 
> confident that the "declare" attribute can be effectively 
> used from within DITA.
> 
> In addition: Given that DITA is a multi-channel publishing 
> format, the meaning of each attribute should  be defined 
> either in a platform-independent way or at least with respect 
> to print and online help formats.
> 
> > -----Original Message-----
> > From: Don Day [mailto:dond@us.ibm.com]
> > Sent: Thursday, January 05, 2006 6:27 AM
> > To: Paul Prescod
> > Cc: dita@lists.oasis-open.org; Su-Laine Yeo
> > Subject: Re: [dita] Name attribute of object element
> >
> > As you note, I can vouch that the related object and param elements 
> > were borrowed literally from XHTML.  There was no point in 
> reinventing 
> > yet another object description method since the XHTML model 
> > demonstrates reasonable functionality that many help 
> authors already 
> > understand.  HTML attributes were retained to allow 
> passthrough of the 
> > setup data for end uses.  The Required error was probably 
> copied from 
> > the W3C spec before the final values for DITA were adjusted.
> >
> > I agree that this is an edit change for the 
> commonLRdefs.dita file in 
> > the Language Spec.  Editors, how shall we log and track 
> this and other 
> > minor edits we've come across?  I plan to discuss the TC's Wiki on 
> > Tuesday--think about a log/response format we can use there.
> >
> > In processing, the content for this element (with some 
> modification to 
> > the description content, if present) flows literally into 
> XHTML. For 
> > FO output, the expectation is that this multimedia content is 
> > meaningless, and therefore elided in the original FO 
> transforms (which 
> > place an empty block for now).  Authors who intend to print a topic 
> > that contains an object should consider providing alternate 
> content, 
> > selected conditionally.
> >
> > 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
> >
> >
> >
> >
> >              "Paul Prescod"
> >
> >              <paul.prescod@bla
> >
> >              stradius.com>
> >           To
> >
> > <dita@lists.oasis-open.org>
> >              01/04/2006 08:51
> >           cc
> >              PM                        "Su-Laine Yeo"
> >
> >
> > <su-laine.yeo@blastradius.com>
> >
> >      Subject
> >                                        [dita] Name 
> attribute of object
> >                                        element
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> >
> > The DITA language reference[1] says:
> >
> > name  | Submit the object as part of a form. | CDATA | 
> #REQUIRED | Yes
> >
> > [1] http://docs.oasis-open.org/dita/v1.0/langspec/object.html
> >
> > But the DTD does not say that it is required.
> >
> > Overall, the specification of the object tag does not seem to
> > fit logically in with the rest of the DITA specification. I
> > presume it is closely based upon the HTML tag of the same
> > name? For example: what other elements have a "tabindex"
> > attribute? Or an HTML-specific "name"
> > attribute?
> >
> >  Paul Prescod
> >
> >
> >
> 
> 
> 
> 
> 


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