review

A  review  is a post evaluating a product or service, usually involving a written description, sometimes with summary numerical evaluations, also known as just a rating if it’s just a single numerical value or iconic representation like stars (★★★★☆).

Why
You should own your reviews, just like you own your comments.

How to publish
Current review publishing best practice is to post an h-review as you would otherwise post an h-entry.

(markup example needed!)

Tantek
undefined has occassionally manually posted reviews since at least 2006-07-18, e.g.:
 * http://tantek.com/log/2006/07.html#d18t1732
 * restaurant reviews of Rare View and a Starbucks
 * https://tantek.com/log/2006/07.html#d19t1832
 * service/event reviews of intermediate yoga by Jenny Pommiss and Pilates Mat class by Kristin McGee
 * restaurant reviews of Live Bait and Chez Laurence

Aaron Parecki
has posted a review as a note, without explicit h-review markup: http://aaronparecki.com/notes/2015/06/23/1/echo
 * since 2016-12-15, he added h-review support to p3k and Quill and now can post reviews with Microformats 2 and 1 markup
 * e.g. https://aaronparecki.com/2016/12/15/11/bose-solo-15-sound-system-review
 * all: https://aaronparecki.com/reviews

Since 2019-10-06, has also posted "tips" on his site syndicated to Foursquare
 * https://aaronparecki.com/2019/10/06/20/foursquare

gRegor Morrill
has posted reviews with h-review markup as of 2017-04-02. My intent was initially to post a recipe with a link to Blue Apron recipes I've enjoyed, then I realized it was easy to wrap in an h-review at the same time:
 * https://gregorlove.com/2017/04/pan-seared-chicken-with-roasted-honeynut/

Previously I had posted a review as an article, without explicit h-review markup:
 * http://gregorlove.com/2015/08/review-a-thousand-lives/

Christian Weiske
has posted reviews with Microformats 1 hreview classes
 * http://cweiske.de/tagebuch/patriot-tab-16gb.htm
 * Appears as a Google summary: https://encrypted.google.com/search?hl=de&q=Patriot%20Tab%2016GB#hl=de&q=Patriot+Tab+16GB+cweiske

Chris Aldrich
has been posting reviews since at least 2018-12-30:
 * Example with rating: 🎞️ Mary Poppins Returns (2018) | Walt Disney Pictures

Dan Q
added h-review reviews to his site in 2019, retroactively PESOS-importing reviews from several silos, e.g.:
 * Review imported from Google Maps with out-of-5 rating and h-card
 * Review imported from TripAdvisor with out-of-5 rating and h-card; note that TripAdvisor allows reviews to report on multiple 5-point scales but this isn't reflected in my site (yet)
 * Review imported from Steam with "recommended"/"not recommended" (0-1) rating and basic h-product
 * Review imported from Amazon with out-of-5-rating and basic h-product

Shane Becker
has posted reviews as articles, without explicit h-review markup:
 * https://veganstraightedge.com/articles/2006/11/18/review-y-the-last-man (archived)
 * https://veganstraightedge.com/articles/2006/11/18/review-dmz (archived)
 * https://veganstraightedge.com/articles/2006/11/18/review-ultimate-spiderman (archived)
 * https://veganstraightedge.com/articles/2006/11/18/review-powers (archived)

Past Examples
The following examples are offline. Please help restore their links with Internet Archive links for historical purposes!

Kyle Mahan
has posted reviews with explicit h-review markup
 * Archived example
 * Archived page listing reviews

Amazon
Amazon is a review and ratings silo of sorts, in that they have a UI for creating reviews/ratings and host them on their own site.

Goodreads
Goodreads is a silo for keeping track of books, reviews, and reading progress. Amazon purchased Goodreads in 2013.

Yelp
Yelp is a review silo that also allows for checkins.

AirBnB
AirBnB also hosts reviews in addition to its primary use-case.

Letterboxd
Letterboxd is a silo for keeping track of films and reviews in what they call a "film diary".

IMDB
IMDb is a large film and television database and silo that allows for rating content, writing reviews, creating watchlists, and adding media checkins among other functionalities.

GitHub
GitHub allows posting of reviews as a response to a pull request. E.g.
 * https://github.com/mozilla/standards-positions/pull/66#pullrequestreview-101356976

When you're looking at a pull request on GitHub, the Files changed tab in particular, there's a "Review changes" drop-down in the topright of the view of the diffs.

Clicking it shows:
 * "Review summary" text field,
 * as well as radio group for
 * Comment
 * Approve
 * Request changes, and then
 * a "Submit review" button

Google Maps ("Google Places")
Reviews posted about places registered on Google My Business appear on Google Maps, via their app, etc. They have individual URLs which could be useful for syndication, e.g. https://www.google.com/maps/contrib/103645469476905576119/place/ChIJlYd0JcPEdkgRua5jm4pBRBA. Being as they're reviews of businesses with real locations, reviews of this kind might benefit from h-card metadata.

Additional details about Google Reviews and their system: https://support.google.com/maps/answer/6230175

POSSE to GitHub
It would be great to be able to post a review of a pull request to my own site, and POSSE it to GitHub, though this requires at a minimum marking up:
 * review summary/content - which h-review (and h-entry for that matter) already supports
 * choice of comment/approve/request changes
 * "comment" could just be the silent default - no other markup needed. just an h-review with content should work to make this work.
 * "approve" needs some explicit indication.
 * use a tag? approve
 * similarly: changes for request changes
 * or a custom rating field per h-review?
 * or ... ?

Next steps:
 * figure out some markup (perhaps gather at least one more silo example for which the markup would make sense)
 * experiment with a manual pull request review on an indieweb site
 * experiment with manually POSSEing it to GitHub
 * file an issue on Bridgy Publish to support POSSEing h-review posts of GitHub pull request URLs. Or perhaps allow minimum viable comment + special-tags for Bridgy to detect. Or encourage / allow both? (why? why not just use the minimum makrup that would work?)