Skip to content

Hotels v2#1224

Merged
danbri merged 53 commits intoschemaorg:sdo-makemakefrom
mfhepp:hotels-v2
Jul 19, 2016
Merged

Hotels v2#1224
danbri merged 53 commits intoschemaorg:sdo-makemakefrom
mfhepp:hotels-v2

Conversation

@mfhepp
Copy link
Contributor

@mfhepp mfhepp commented Jun 23, 2016

This pull-request addresses #915 and supersedes #916.
I implemented all the changes as agreed in #915 (comment).

The following minor additions or modifications turned out to be necessary:

  1. The new type MealService had to be named http://schema.org/FoodService to avoid a clash with the existing mealService property.
  2. The text for the bed property was left unchanged because it seems sufficiently generic at second sight.

I also implemented a few additional improvements, e.g. links from core types to /docs/hotels.html.

The changes are very transparent due to the many small commits in my fork at https://github.com/mfhepp/schemaorg/commits/hotels-v2.

A preview of this work is available at:

mfhepp added 30 commits August 6, 2015 12:59
…ected containedInPlace renaming and containsPlace inverse property, added Room class and moved roomNumber thereto
@mfhepp
Copy link
Contributor Author

mfhepp commented Jul 18, 2016

Dear Dan,
any news on this?
Martin

@danbri
Copy link
Contributor

danbri commented Jul 18, 2016

@mfhepp I'll convert it into a pending.schema.org extension this week, and propose it to go out imminently with a 3.1 release.

@mfhepp
Copy link
Contributor Author

mfhepp commented Jul 18, 2016

thanks!


martin hepp
www: http://www.heppnetz.de/
email: [email protected]

Am 18.07.2016 um 16:50 schrieb Dan Brickley [email protected]:

@mfhepp I'll convert it into a pending.schema.org extension this week, and propose it to go out imminently with a 3.1 release.


You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub, or mute the thread.

@danbri
Copy link
Contributor

danbri commented Jul 19, 2016

Upon consideration I think this is not a good fit for pending, so let's do it in one hop. Pending works well when we are purely adding new vocabulary; here there are lots of integration points with the existing core.

@danbri
Copy link
Contributor

danbri commented Jul 19, 2016

Reviewing: @mfhepp is there any reason for starRating to be scoped as only applying to lodging businesses? all kinds of things get awarded star-like ratings...

/cc #780 #668 since the hotels work proposes a design for starRating

<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/Demand">Demand</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Product">Product</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Service">Service</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Accommodation">Accommodation</a></span>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are we adding Accommodation to itemOffered? Shouldn't authors use MTEs (Accommodation and Product/Service as appropriate) for this?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On 19 Jul 2016, at 18:41, vholland [email protected] wrote:

In data/schema.rdfa:

@@ -5592,6 +5613,7 @@ Note that Event uses startDate/endDate instead of startTime/endTime, even when d
Domain: Demand
Range: Product
Range: Service

  •  <span>Range: <a property="http://schema.org/rangeIncludes" href="proxy.php?url=http://schema.org/Accommodation">Accommodation</a></span>
    

Why are we adding Accommodation to itemOffered? Shouldn't authors use MTEs (Accommodation and Product/Service as appropriate) for this?

  1. Because MTEs do not work (as of now) in Google's toolchain, so anybody adopting this would battle with validation errors.
  2. Because we agreed on that design in the conference call a few months ago.
  3. Because many of the properties of Product/Service are not really applicable to hotel rooms etc. (e.g. GTIN).

Also, we want to point people to the fact that an offer can include a hotel room etc.

While in GoodRelations, Product was essentially a role notion for Thing, implying that it is the object in an offer, we silently narrowed Product in schema.org to commodities. You can see this also in the fact that Service is not subtype of Product in schema.org, while it is included in the ProductOrService class in GR.

@danbri
Copy link
Contributor

danbri commented Jul 19, 2016

re http://sdo-hotels.appspot.com/Accommodation

@mfhepp @vholland should we hop onto a skype/hangout/phone call to talk this through?

We have an awkward little shopping list of terms on 'itemOffered' and another on 'offers'. Should we be trying to keep those two in sync, at least?

@danbri
Copy link
Contributor

danbri commented Jul 19, 2016

Here's what I suggest. I will merge this into sdo-makemake (our work in progress towards a v3.1 release), but I do not feel confident proposing the resulting design as a consensus candidate release to our steering group, since we have at least 2 steering group members here (Vicki and Martin) still working out some details. I'm confident we'll figure something out and the merge covers a lot of useful ground, so let's get all our drafts in one place for serious review and finalization.

@danbri danbri merged commit 336de88 into schemaorg:sdo-makemake Jul 19, 2016
danbri added a commit that referenced this pull request Jul 19, 2016
@danbri
Copy link
Contributor

danbri commented Jul 19, 2016

Merged and ran tests. I get some errors:

test_validDomainIncludes (test_graphs.SDOGraphSetupTestCase) ... 

INFO:test_graphs:Property http://schema.org/numberOfRooms invalid domainIncludes value: http://schema.org/SingleFamilyHome
INFO:test_graphs:Property http://schema.org/occupancy invalid domainIncludes value: http://schema.org/SingleFamilyHome

======================================================================
FAIL: test_validDomainIncludes (test_graphs.SDOGraphSetupTestCase)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "/Users/danbri/sdo/official/schemaorg/tests/test_graphs.py", line 179, in test_validDomainIncludes
    self.assertEqual(len(nri1_results), 0, "DomainIncludes should define valid type. Found: %s" % len(nri1_results))
AssertionError: DomainIncludes should define valid type. Found: 2

----------------------------------------------------------------------
Ran 73 tests in 56.298s

I am commenting out mentions of that type for now. @mfhepp please advise!

@danbri
Copy link
Contributor

danbri commented Jul 19, 2016

Ok the tests now pass, so I have pushed this out to our work-in-progress site, http://webschemas.org/docs/hotels.html

TODO: Note that we will need to add an entry to docs/releases.html summarizes this change.

@danbri
Copy link
Contributor

danbri commented Jul 20, 2016

Searching around, I found https://schema.org/SingleFamilyResidence and assume now that SingleFamilyHome was intended as a reference to this (long existing) type. I will re-instate the references but to SingleFamilyResidence if @mfhepp can confirm this was the intended design.

danbri added a commit that referenced this pull request Jul 20, 2016
@danbri
Copy link
Contributor

danbri commented Jul 20, 2016

I've gone ahead and made that change (SingleFamilyHome -> SingleFamilyResidence).

@mfhepp
Copy link
Contributor Author

mfhepp commented Jul 21, 2016

@danbri I think the (SingleFamilyHome -> SingleFamilyResidence) is fine.

@mfhepp
Copy link
Contributor Author

mfhepp commented Jul 21, 2016

On 19 Jul 2016, at 18:39, Dan Brickley [email protected] wrote:

Reviewing: @mfhepp is there any reason for starRating to be scoped as only applying to lodging businesses? all kinds of things get awarded star-like ratings...

It can of course be applied to other entity types, but the consensus in our conference call was to start small and expand it later as needed. Feel free to broaden the domain if you think this is appropriate.

Martin

@mfhepp
Copy link
Contributor Author

mfhepp commented Jul 21, 2016

On 19 Jul 2016, at 18:52, Dan Brickley [email protected] wrote:

re http://sdo-hotels.appspot.com/Accommodation

@mfhepp @vholland should we hop onto a skype/hangout/phone call to talk this through?

We have an awkward little shopping list of terms on 'itemOffered' and another on 'offers'. Should we be trying to keep those two in sync, at least?

Yes, they should be in sync; feel free to add more classes to itemOffered.

Note that this is the consequence that schema.org did not adopt the design pattern in GoodRelations of having all tradeable things as a subtype of ProductOrService. Because you did not want this, we have to tweak the domains and ranges whenever we discover that a new type of things can be part of an offer (e.g. CreativeWork), and this will go on as the scope of schema.org emerges.

Also note that an Event can, in my understanding, not really be offered. You can offer access or other rights to / on an event, as we did in the Tickets Ontology, see http://www.heppnetz.de/ontologies/tio/ns.

But be it like it is; the growing inconsistency in schema.org is the result of premature optimizations decided upon the in the past years when conceptual clarity was sacrificed for perceived simplicity for Web developers in particular use-cases.

Martin

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants