Difference between revisions of "hlisting-brainstorming"

From Microformats Wiki
hlisting-brainstorming
Jump to navigation Jump to search
(adding item back)
(unbolding...)
Line 12: Line 12:
 
** dtexpired. optional. ISO8601 absolute date time.
 
** dtexpired. optional. ISO8601 absolute date time.
 
** price. optional. text. [should include a floating-point number with optional ISO currency codes] - see the currency proposal
 
** price. optional. text. [should include a floating-point number with optional ISO currency codes] - see the currency proposal
** item info. '''optional'''. (fn || url || photo || [[geo]] || [[adr]]) |  [[hcard|hCard]] (for person or business).  
+
** item info. optional. (fn || url || photo || [[geo]] || [[adr]]) |  [[hcard|hCard]] (for person or business).  
 
** summary. optional. text.
 
** summary. optional. text.
 
** '''description'''. required. text with optional valid XHTML markup.
 
** '''description'''. required. text with optional valid XHTML markup.

Revision as of 21:06, 22 April 2009

listing microformat brainstorming

This is brainstorming for a hListing draft microformat per the The microformats process.

Revised Base Schema Elements (proposed)

  • hListing (hlisting)
    • listing action. optional. one or more tags, suggested set: sell | rent | trade | meet | announce | offer | wanted | event | service
    • lister. optional. hCard | (fn || email || url || tel).
    • dtlisted. optional. ISO8601 absolute date time.
    • dtexpired. optional. ISO8601 absolute date time.
    • price. optional. text. [should include a floating-point number with optional ISO currency codes] - see the currency proposal
    • item info. optional. (fn || url || photo || Geo || adr) | hCard (for person or business).
    • summary. optional. text.
    • description. required. text with optional valid XHTML markup.
    • item tags. optional. keywords or phrases describing the item being offered, using rel-tag
    • permalink. optional.
    • availability. optional. text.
    • condition. optional. text. examples: 'new', 'used', 'refurbished'.
    • shipping. optional. text. text describing shipping and fulfillment


Items removed

  • version. optional. text.
  • item info. optional. (fn || url || photo || geo || adr) | hCard (for person or business).
  • Removal of item seems to be a mistake, as that is used to indicate the item itself being listed. E.g., a nested hProduct would be <p class='item hproduct'></p>. Removal appears to leave no way to include what is being listed. --BenWard 17:38, 16 April 2009 (UTC)
    • +1 completely agreed with Ben Ward's point. Wide use of hReview 0.4 (in progress) in the wild has shown that having an explicit "item" is both necessary and works in practice. Tantek 17:40, 16 April 2009 (UTC)
  • Indeed it was a mistake... left it out of my edits. Replaced. JayMyers 21:04, 22 April 2009 (UTC)

Items added

  • Each of the following should cite the analysis made of real world examples that demonstrates the 80%+ use case need, otherwise, they should not be added. Tantek 17:45, 16 April 2009 (UTC)
  • availability. optional. text.
  • condition. optional. text. examples: 'new', 'used', 'refurbished'.
  • shipping. optional. text. text describing shipping and fulfillment

Items changed:

  • listing action => optional. if omitted, action assumed to be sell
  • lister => optional. if omitted, the buyer/seller is assumed to be the site where the microformat exists
  • In that case, an algorithm should be provided for how to determine the hCard for the lister, if no explicit lister is given. Tantek 17:45, 16 April 2009 (UTC)