[uf-new] hResume issue: embedding hCard for job title leads to ambiguities.

[Toby Inkster]

I quickly documented this issue on the wiki yesterday:

http://microformats.org/wiki/hresume-issues#issue-20100317

While porting/testing my hResume parser, I ran into an issue. It is
suggested that to mark up job titles, roles, etc within hResume
experiences, an hCard should be embedded into the experience. I'm going
to call this the "JThC" (Job Title hCard), just because I'd like a term
to unambiguously refer to it.

With the experience already being an hCalendar event, there are several
places an hCard could already legitimately be embedded within it - e.g.
class="location vcard". So the issue is that there's not really any way
to differentiate between the JThC versus other hCards within the
experience.

There seem to be three possible ways of disambiguating - two that
involve spec changes, and one that doesn't but I think would be less
reliable and harder to implement.

1. The JThC should be given class="contact" within the hCalendar event.
The CONTACT property is defined in RFC 2445 (iCalendar) as:

   Purpose: The property is used to represent contact information or
   alternately a reference to contact information associated with the
   calendar component.

So an hResume experience would look something like:

  <div class="experience vevent">
    <h3 class="summary">
      <abbr class="dtstart" title="2005-05-01">May 2005</abbr> -
      <abbr class="dtend" title="2008-06-24">June 2008</abbr> -
      <i class="contact vcard">
        <a href="#name" class="include"></a>
        <span class="title">Senior Vice-President</span>
        <span class="org">CompuGlobalHyperMeganet</span>
      </i>
    </h3>
    <p class="description">
      This industry moves so fast it's really hard to tell.
    </p>
  </div>

2. Same dealy, but defining a new hResume-specific property rather than
reusing hCalendar's contact property. e.g.

  <div class="experience vevent">
    <h3 class="summary">
      <abbr class="dtstart" title="2005-05-01">May 2005</abbr> -
      <abbr class="dtend" title="2008-06-24">June 2008</abbr> -
      <i class="me vcard">
        <a href="#name" class="include"></a>
        <span class="title">Senior Vice-President</span>
        <span class="org">CompuGlobalHyperMeganet</span>
      </i>
    </h3>
    <p class="description">
      This industry moves so fast it's really hard to tell.
    </p>
  </div>

3. This is the option which requires no spec changes. We simply specify
that the JThC is the first hCard within the experience which is not also
a location/attendee/organizer/contact(?) hCard.

  <div class="experience vevent">
    <h3 class="summary">
      <abbr class="dtstart" title="2005-05-01">May 2005</abbr> -
      <abbr class="dtend" title="2008-06-24">June 2008</abbr> -
      <i class="vcard">
        <a href="#name" class="include"></a>
        <span class="title">Senior Vice-President</span>
        <span class="org">CompuGlobalHyperMeganet</span>
      </i>
    </h3>
    <p class="description">
      This industry moves so fast it's really hard to tell.
    </p>
  </div>

-- 
Toby A Inkster
<mailto:mail at tobyinkster.co.uk>
<http://tobyinkster.co.uk>