schemaorg / suggestions-questions-brainstorming

Suggestions, questions, and brainstorming
20 stars 15 forks source link

Clarify that itemReviewed can be repeated (s/the/an/) and that conventions will vary by subtype #128

Open danbri opened 6 years ago

danbri commented 6 years ago

(See schemaorg/schemaorg#1828 and schemaorg/schemaorg#1969 for more context)

We should clarify that sometimes a single review covers multiple items. This is atypical in the general case, but since we have a range of review types (Review, UserReview, CriticReview, and ClaimReview for fact-checking), it is time to note that sometimes there are multiple items covered.

This is important for our fact-check markup efforts, but it seems a sensible clarification to make. I looked through the Reviews section of a paper NYT as informal research. Most of the reviews there were primarily about one thing (book etc.), but there was a full page review that embraced several books within a single writeup.

Proposal is:

  1. revise the definition to be "An item that is being reviewed/rated." instead of "The item that is being reviewed/rated.")
  2. Close schemaorg/schemaorg#161 by cross-referencing 'review' and 'itemReviewed'.
  3. Add/amend a few words to the common supertype "Review", along lines that it is typically "an" item, but can be several, and that different Review subtypes may have stronger conventions.

My comments in the fact-check thread copied here:

I'd like to say

  • "itemReviewed" in general case: most typically points to a single thing
  • but can point to several things, if a review is reviewing several things
  • conventions and common patterns may vary between the different subtypes of Review (UserReview, CriticReview, ClaimReview etc.).
  • Fact checking reviews (reviews of Claims, i.e. ClaimReview) can use repeated itemReviewed to describe various appearances of several claims that it makes sense to evaluate within a common review (i.e. fact-check). We need not be strict here about whether they are multiple appearances of exactly the same claim, or variations on a theme.
  • Other kinds of reviews sometimes have multiple items reviewed in an integrated writeup, this is probably more typical of critic reviews than user reviews, and what we do here for fact checking shouldn't impact those other types, beyond the general clarification that "itemReviewed" is sometimes repeated.
  • We can note that it is possible to use the various properties of the items reviewed (their publication dates, or perhaps mainEntityOfPage markup) to point to the earliest or primary item, if there are several. Note that we are not imposing a single approach to that matter here. Conventions may emerge, and they may be subtype-specific.
RichardWallis commented 4 years ago

See issue #7 for the context of the move from the main Schema.org issue tracker to this repository.