hreview-faq

From Microformats Wiki
Revision as of 01:36, 2 February 2006 by Tantek (talk | contribs) (use tags for stocks also)
Jump to navigation Jump to search

hReview FAQ

This page is for documenting Q&A about hReview. If you have a new question to ask, Please consider first asking your question on the microformats-discuss list.

Q&A

  1. How do you specify more detail for the 'type' field, e.g. for an item of type "product" that is a book, or a movie (on DVD or in a theater), or a music CD? -- paraphrased from Dougal Campbell 11:54, 21 Jun 2005 (PDT)
  2. What is the difference between the 'website' and 'url' type? --Dougal Campbell 11:54, 21 Jun 2005 (PDT)
    • A 'website' presumably includes everything located on that site, whereas 'url' refers only to the particular page located at the given 'url'.
  3. What if I want to use hReview to review a podcast? Which type should I use?
    • As a podcast is typically a specific URL (often ending with ".mp3") the "url" item type should be used when publishing an hReview of a podcast.
  4. What is the proper 'type' to use for a restaurant?
    • A restaurant is a "business".
  5. Is there a standard way to add information that isn't in the default list of fields? It seems like book reviews should include the author's name, but there's no obvious way to add it to the markup. The example reviews include it in the text, but it's not part of their markup. Chris Hibbert
  6. How do I state the scale of the rating field? Kal Ström
  7. Is there some recommendation as to the url for movies, imdb perhaps? - Judson Dunn 12:40, 17 Dec 2005 (PST)
    • Many users use imdb.com URLs to refer to movies. Others use amazon.com or other DVD etc. product URLs to refer to movies. Some even use the URLs to specific movie sites themselves, e.g. whatisthematrix.com. Some also use URLs to movie traliers on movie trailer sites. You should use whatever you think best represents the specific item you are reviewing. Microformats.org does not make a recommendation to use one of the above in particular. - Tantek
  8. Can the item being reviewed have more than one photo?
    • Yes. In general if the specification does not explicitly forbid it, a property may take multiple values (or be specified multiple times).
  9. Is there a recommended way to use hReview to "rate" stocks?
    • Typically what you are rating is not the stock, but the company behind the stock, which would simply be an item of 'type' 'business', and you would include an hCard for the company. If you are actually rating a specific stock (for example in the case where a company has more than one type of stock for trade), then in essence you are reviewing a 'product' which is bought and sold. In that case, you can specify the item 'type' to be a 'product', and then use a standard stock market name for the stock symbol, e.g. "NYSE:T" for AT&T stock, "NasdaqNM:MSFT" for Microsoft stock, "DJI:^DJI" for the Dow Jones Industrial Average. More such scoped names for stocks can be found by looking them up on Yahoo! Finance, and you could even use a stock's Yahoo! Finance URL as the item's 'url' in the hReview, e.g. as linked from the examples listed.
    • In addition, see the FAQ#1 above. As a "stock" is a particular kind of product, you should probably tag the item in the hReview with a set of tags, e.g.:
      • <a href="http://technorati.com/tag/stock" rel="tag">stock</a>
      • <a href="http://technorati.com/tag/msft" rel="tag">msft</a>
      • ... etc.
  10. Should rated tags show up alongside other tags in an hReview?
    • Both rated tags and normal tags apply to the item being reviewed, and thus both are in the total set of tags for the item. As far as where they should show up, that is up to the user interface of the software or service that is displaying the hReviews.

See Also