RE: [docbook-tc] personblurb in address?

[Nancy P Harrison <nancyph@us.ibm.com>]

At the risk of roiling the waters...

While I agree that the best way to make
Scott's task easier is to have all the info in a 'person'-type element,
rather than in the address element, I'm not sure how adding a person element
fulfills our mission of supporting the delivery of technical documentation.
At the meeting yesterday, we specifically rejected an RFE for being out-of-scope,
and this request seems equally out-of-scope to me.  If a company  really
wants to create an employee directory in DocBook, they already can, using
[and maybe aliasing?] the 'othercredit' element, which matches author and
editor in content.   

But I don't see how generic 'person'
content is applicable to technical documentation.  If we add person,
we should also take another look at the RFE we rejected yesterday

just my $.02

Nancy


"Dick Hamilton" <rlhamilton@frii.com>
wrote on 03/15/2006 08:58:40 PM:

> I agree that it's a bit strange to have either authorblurb or
> personblurb in address.  I wonder why authorblurb ever ended
> up there in the first place.  
> 
> I'd be more comfortable generalizing the higher level structure
> (author, editor) to something like <person> and use an attribute
> to identify the kind of person (author, editor, DocBook Geek).
> Or add <person> with the same content model, which might be
better
> since author and editor are pretty deeply ingrained and (at least
> author) probably used in nearly every document.
> 
> Either option would make it possible to fully identify all sorts
> of people and not add extra stuff to their addresses.
> 
> Dick
> rlhamilton@frii.com
> 
> > -----Original Message-----
> > From: Scott Hudson [mailto:scott.hudson@flatironssolutions.com]
> > Sent: Wednesday, March 15, 2006 11:39 AM
> > To: Norman Walsh
> > Cc: docbook-tc@lists.oasis-open.org
> > Subject: Re: [docbook-tc] personblurb in address?
> > 
> > 
> > Here's my situation, IHAC that is standardizing on DocBook 
> > 4.5 and has a 
> > variety of publications. Most are very straightforward, but 
> > they would 
> > also like to publish their Employee Directory using DocBook.
> > That means 
> > for each entry, there will be a name, address, phone, email,
etc.
> > 
> > They would also like to put in a biography and/or job 
> > description. This 
> > is where I thought personblurb would make the most sense, so
the 
> > directory would look something like:
> > <book>
> > <title>Employee Directory</title>
> > <chapter>
> > <title>Communications Division</title>
> >   <address>
> >     <personname>
> >       <firstname>Scott</firstname><surname>Hudson</surname>
> >     </personname>
> >     <affiliation>
> >       <orgname>Flatirons Solutions</orgname>
> >       <orgdiv>Communications</orgdiv>
> >     </affiliation>
> >     <email>scott.hudson@flatironssolutions.com</email>
> >     <phone>303-542-2146</phone>
> >     <fax>303-544-0522</fax>
> >     <street>4747 Table Mesa Drive, Suite 200</street>
> >     <city>Boulder</city> <state>CO</state>
<postcode>80305</postcode>
> >     <authorblurb><para>Scott likes DocBook.
He's a 
> > certifiable DocBook 
> > geek, and a member of  the OASIS TC.</para></authorblurb>
> >   </address>
> > </chapter>
> > </book>
> > 
> > Best regards,
> > 
> > --Scott
> > 
> > P.S., Plaxo is just a service I use. I got tired of maintining
my 
> > addressbook in multiple places, and it syncs to Outlook and 
> > Thunderbird.
> > 
> > Norman Walsh wrote:
> > > / Scott Hudson <scott.hudson@flatironssolutions.com>
was 
> > heard to say:
> > > | according to http://docbook.org/tdg/en/html/address.html,
> > authorblurb
> > > | is allowed in address. Why is personblurb not also allowed
(if the
> > > | address is describing someone, say in an employee 
> > directory, rather
> > > | than an author)?
> > >   
> > > | Perhaps personblurb should be part of person.ident.mix?
> > >
> > > Both seem a little bizarre to me. Why is the blurb part
of 
> > the address?
> > > Note that in 5.0, neither is allowed.
> > >
> > >   http://docbook.org/tdg5/en/html/address.html
> > >
> > > Allowing biblioref looks a bit odd in there but it's a 
> > consequence of
> > > allowing link and xref. I'm not sure what I think about
that.
> > >
> > > | /Add me to your address book.../
> > > | 
> > <https://www.plaxo.com/add_me?u=17180023598&v0=298305&k0=537541243>
> > >
> > > Is plaxo a service that you're using personally, or something
that
> > > Flatiron uses? (Just curious.)
> > >
> > >                
                     
  Be seeing you,
> > >                
                     
    norm
> > >
> > >   
> > 
> > 
> > -- 
> > 
> >  
> > 
> >  
> > 
> > Flatirons Solutions
> > /*Vision. Experience. Engineering Excellence.*/ 
> > <http://www.flatironssolutions.com>
> > 
> >    
> > 
> > 
> >    
> > 
> >  
> > 
> > *Scott Hudson*
> > /Senior Consultant/
> > 
> >    
> > 
> > *Flatirons Solutions*
> > 4747 Table Mesa Drive Suite 200
> > Boulder, CO 80305 
> > <http://maps.yahoo.com/py/maps.py?Pyt=Tmap&addr=4747+Table+Mes
> a+Drive+Suite+200&csz=Boulder%2C+CO+80305&country=us> 
> 
> 
> scott.hudson@flatironssolutions.com 
> <mailto:scott.hudson@flatironssolutions.com>
> web:http://flatironssolutions.com <http://www.flatironssolutions.com>
> blog:http://scottysengineeringlog.net
> 
>    
> 
> tel:
> fax:
> mobile:
> 
>    
> 
> 303-542-2146
> 303-272-7069
> 303-332-1883
> 

____
Nancy Harrison
IBM Rational Software
Phone: 781-676-2535
nancyph@us.ibm.com