Skip to content

Suggest EndorsementRating subtype of Rating to indicate supportive ratings #1293

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
danbri opened this issue Aug 10, 2016 · 5 comments
Closed
Assignees
Labels
schema.org vocab General top level tag for issues on the vocabulary

Comments

@danbri
Copy link
Contributor

danbri commented Aug 10, 2016

Currently we have "Rating: A rating is an evaluation on a numeric scale, such as 1 to 5 stars."

Suggest amending to "an evaluation, commonly on a numeric scale", and creating a subtype EndorsementRating with definition "A positive rating that expresses a positive evaluation or endorsement."

Justification: some situations e.g. "pick of the week" critic's reviews, are implicitly positive. However if a numeric scale is not used, it is impossible to tell that the Rating should be taken as an endorsement.

We should also note that Rating is associated with some properties e.g. bestRating that assume a numeric scale ("The highest value allowed in this rating system. If bestRating is omitted, 5 is assumed."). We may need to soften this language to deal with non-numeric, non-scaled endorsement ratings (if necessary an unscaled endorsement can be seen as implicitly 5/5).

A related option would be for a Text-values of http://schema.org/ratingValue (e.g. "Critic's pick") to indicate a non-scalar system, in which case bestRating and worstRating would say "if bestRating is omitted and ratingValue is a number, 5 can be assumed."

Nearby: #780 for starRating discussion

/cc @gmackenz

@danbri danbri added the schema.org vocab General top level tag for issues on the vocabulary label Aug 10, 2016
@danbri danbri self-assigned this Aug 10, 2016
@thadguidry
Copy link
Contributor

thadguidry commented Aug 10, 2016

@danbri So this idea would also allow someone like me, an avid PC Gamer on Steam to express that I 'Recommend' this game ?

<div style="clear: left;"></div>
    <div class="review_box">
      <div class="header">2 of 8 people (25%) found this review helpful</div>
      <div style="clear: left;"></div>
      <div class="review_box_content">
        <div class="leftcol">
          <a href="http://steamcommunity.com/app/232810">
            <img src="http://cdn.akamai.steamstatic.com/steamcommunity/public/images/apps/232810/e2a7637399293a7d2406157e6e4b833d519526ec.jpg" />
          </a>
        </div>
        <div class="rightcol">
          <div class="vote_header">
            <div class="thumb">
              <a href="http://steamcommunity.com/id/thadguidry/recommended/232810/">
                <img src="http://steamcommunity-a.akamaihd.net/public/shared/images/userreviews/icon_thumbsUp.png" width="44"
                height="44" />
              </a>
            </div>
            <div class="title">
              <a href="http://steamcommunity.com/id/thadguidry/recommended/232810/">Recommended</a>
            </div>
            <div class="hours">26.9 hrs on record</div>
          </div>
          <div class="early_access_review tooltip"
          data-tooltip-content="This review was written while Godus was marked as Steam Early Access">Early Access Review</div>
          <div class="content">THIS GAME BRINGS WITH IT ONE OF THE MOST DEFINING MOMENTS IN PC GAMING HISTORY.

@danbri
Copy link
Contributor Author

danbri commented Aug 10, 2016

The sketch came less from thinking about +1/Like/etc in the social network / media sense, more like review+rating in a newspaper or blog. But perhaps they're pretty much the same.

danbri added a commit that referenced this issue Aug 18, 2016
@danbri
Copy link
Contributor Author

danbri commented Aug 18, 2016

I've had a go at implementing this in pending, and in doing so articulating how this relates to EndorseAction.

-> http://pending.webschemas.org/EndorsementRating

If we go for this, let's also update and link from http://schema.org/EndorseAction too.

How does this look?

@danbri
Copy link
Contributor Author

danbri commented Feb 19, 2019

This is seeing some usage, e.g. Zagat, Fodors.

Let's move it along into core.

... 
{"@type":"EndorsementRating","name":"Zagat Rated","ratingValue":"4.5"}]}}

(seems to be Javascript-injected, in https://www.zagat.com/r/smoke-shack-bbq-san-antonio if you look via browser inspection)

Also https://www.fodors.com/world/north-america/usa/illinois/chicago/hotels/reviews/hotel-palomar-chicago-477853 -


    {
        "@context": "http://www.schema.org",
        "@type": "Hotel",
        "name": "Hotel Palomar Chicago",
        "url": "https://www.fodors.com/world/north-america/usa/illinois/chicago/hotels/reviews/hotel-palomar-chicago-477853",
        "logo": "http://www.fodors.com/images/main-nav-home.svg",
        "image": "https://cimg2.ibsrv.net/cimg/www.fodors.com/500x500_60/66/5a66467f75dee-310066.jpg",
        "description": "Fodor's expert travel writers review the Hotel Palomar Chicago in  and give you the straight scoop, complete with photos, details on the rooms and accommodations, up-to-the-minute pricing via our Rate Checker, local restaurant and bar recommendations, and insider tips for maximizing your stay",
        "telephone": "312-755–9703;877-731–0505",
        "address": {
            "@type": "PostalAddress",
            "streetAddress": "505 N. State, Chicago, Illinois, 60654, USA",
            "addressLocality": "",
            "addressRegion": "",
            "postalCode": "",
            "addressCountry": "",
            "telephone": "312-755–9703;877-731–0505"
        },
        "review": [{
            "@type": "Review",
            "author": "Kristine Hansen",
            "description": "Fodor's expert travel writers review the Hotel Palomar Chicago in  and give you the straight scoop, complete with photos, details on the rooms and accommodations, up-to-the-minute pricing via our Rate Checker, local restaurant and bar recommendations, and insider tips for maximizing your stay",
            "name": "Hotel Palomar Chicago",
            "reviewRating": [{
                "@type": "Rating",
                "bestRating": "5",
                "ratingValue": "4",
                "worstRating": "1"
            },{
                "@type": "EndorsementRating",
                "name": "4 thumbs up",
                "ratingValue": "4"
            }]
        }]
    }

We are using this at Google, e.g. see https://developers.google.com/search/docs/data-types/critic-review.

@RichardWallis
Copy link
Contributor

Implemented in release 3.5

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
schema.org vocab General top level tag for issues on the vocabulary
Projects
None yet
Development

No branches or pull requests

3 participants