hreview-faq
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
- 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)
- The 'type' field was kept delibrately coarse and simple. Any attempt to build a thorough and meaningful taxonomy of all specific types of things that can be reviewed would be futile. Instead, the set of reviewed item types is kept small and fairly generic. Specific "typing" information about the item being reviewed should be published as tags as defined in hReview. E.g. a review of a book would be tagged with a book tag:
<a rel="tag" href="http://en.wikipedia.org/wiki/Book">book</a>. Similarly a movie that was a DVD should be tagged with both:<a rel="tag" href="http://en.wikipedia.org/wiki/Movie">movie</a> <a rel="tag" href="http://en.wikipedia.org/wiki/DVD">DVD</a>. Or a music CD:<a rel="tag" href="http://en.wikipedia.org/wiki/music">music</a> <a rel="tag" href="http://en.wikipedia.org/wiki/CD">CD</a>.
- The 'type' field was kept delibrately coarse and simple. Any attempt to build a thorough and meaningful taxonomy of all specific types of things that can be reviewed would be futile. Instead, the set of reviewed item types is kept small and fairly generic. Specific "typing" information about the item being reviewed should be published as tags as defined in hReview. E.g. a review of a book would be tagged with a book tag:
- 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'.
- 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.
- What is the proper 'type' to use for a restaurant?
- A restaurant is a "business".
- 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
- How do I state the scale of the rating field? Kal Ström
- Please read the rating field description. The default scale is 1 (worst) to 5 (best) and either can be changed by the author. See the multidimensional restaurant review for an example of this. - Tantek
- 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
- 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).
- 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.
- 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.