AW: [dita] Missing <address> elements in DITA 1.1 bookmap <organization> and <person>

["SeicoDyne DITA" <dita@seicodyne.ch>]

Hi Robert,

I still like to find a way to get address information into
<publisherinformation> and maybe also into <editor>, <reviewer> etc.

In the current solution we have an authorinformation element derived from
author.

May I propose to add as topic specialization one new child element into
<publisherinformation>, <author>, <editor> etc e.g. a <contactdetail>
element.

The <contactdetail> element can be used as a general container for any type
of name or addressinformation without needing the xnal domain, and as well
of course for the xnal domain specialization.

Example: use of <contactdetail> without xnal

<publisherinformation>
  <contactdetail type="organizationname">Kone Oy</contactdetail>
  <contactdetail type="location">Hyvinkää</contactdetail> 
  <contactdetail type="country">Finland</contactdetail>
</publisherinformation>

The xnal domain might then be specialized from the <contactdetail> element
instead of the <author> element.

Bookmap.dtd:
<!ENTITY % contactdetail       "contactdetail | %xnal-d-contactdetail;"
>

xnalDomain.ent:
<!ENTITY % xnal-d-contactdetail "contactinformation" >

xnalDomain.mod
<!ELEMENT contactinformation ((%personinfo; | %organizationinfo;)*) >

Example: use of <contactinformation> as part of xnal

<publisherinformation>
 <contactinformation>
  <organizationinfo>
   <namedetails>
    <organizatinnamedetails>
     <organizationname>Kone Oy</organizationname>
    </organizationnamedetails>
   </namedetails>
   <addressdetails>
    <locality>Hynikää</locality>
    <country>Finland</country>
   <oranizationinfo>
 <contactinformation>
</publisherinformation>

What do you think, might that be a reasonable solution.

Best regards

Chris

-----Ursprüngliche Nachricht-----
Von: Robert D Anderson [mailto:robander@us.ibm.com] 
Gesendet: Freitag, 27. April 2007 20:55
An: dita@lists.oasis-open.org
Betreff: Re: [dita] Missing <address> elements in DITA 1.1 bookmap
<organization> and <person>

Hi Chris,

I found the proposal for this change [1] and the minutes from the meeting
where we discussed it [2], but the minutes do not record any of the actual
discussion. I'm pretty sure this side effect was raised at the time, but I
can't find a record of it.

The authorinformation element is based off of <author>. This line in bookmap
says that any place we allow author, we should also allow XNAL
specializations of author:
<!ENTITY % author "author | %xnal-d-author;" >

The personinfo and organizationinfo elements are specializations of <data>.
So, the only way to add them directly to bookmap outside of the
authorinformation container would be as a domain replacement for data. The
personinfo and organizationinfo tags would then show up virtually everywhere
in bookmap, re-creating the problem that forced our original change.

Given that both person and organization are defined in bookmap, it is not
possible to specialize them directly in the XNAL domain. There are still
proposals for DITA 1.2 that would make it easier to integrate bookmap and a
domain, but that won't help with 1.1.

The person and organization elements are allowed in the following contexts:
publisherinformation, published, reviewed, edited, tested, approved,
maintainer, bookowner

All of these have an href attribute. Would it be possible for you to define
a full set of information in the authorinformation tag, and then reference
it with an href? I know many of my users are using this method to provide
more information about the maintainer:
<authorinformation id="maint"> ... </authorinformation> ...
<maintainer href="#maint"/>

I think that the only other options are 1) to allow personinfo and
organizationinfo anywhere we allow data, which is a big usability hit, or
2) remove publisherinformation from bookmap and move it entirely to the XNAL
domain. Both of these seem like very large changes at this point in the
review cycle. What do you think?

Robert D Anderson
IBM Authoring Tools Development
Chief Architect, DITA Open Toolkit
(507) 253-8787, T/L 553-8787

[1] http://lists.oasis-open.org/archives/dita/200606/msg00084.html
[2] http://lists.oasis-open.org/archives/dita/200606/msg00119.html

dita@seicodyne.ch wrote on 04/27/2007 04:32:54 AM:

> For DITA 1.1 we invented xNAL to describe addresses and names.
>
> While upgrading a customers environment from DITA 1.0 to DITA 1.1 we 
> recognized that the address definitions e.g. in publisherinformation 
> of bookmap have not been replaced with xNAL, they have been completely 
> removed.
>
> I guess that removal happend by accident. Indeed, it is a shame that I 
> have not noticed that earlier, and needed a cutomer notified us, but 
> at least it can just in time.
>
> Correcting it might be a minor issue, as we may have to change
>
> bookmap.dtd
> <!ENTITY % author "author | %xnal-d-author;" > into <!ENTITY % author 
> "author | %xnal-d-author;" > <!ENTITY % person "person | 
> %xnal-d-personinfo;" > <!ENTITY % organization "organization | 
> %xnal-d-organizationinfo;" >
>
> and in xNAL.ent
> <!ENTITY % xnal-d-author "authorinformation" > into <!ENTITY % 
> xnal-d-author "authorinformation" > <!ENTITY % xnal-d- person  " 
> personinfo " > <!ENTITY % xnal-d- organization  " organizationinfo " >
>
> Best regards
>
> Chris