Adds HowTo schema and example.#1616
Conversation
|
Thanks, great to see this moving again. Since it is intimately tied to the Recipe structures this makes sense going direct into core schema.org (rather than a pending.schema.org proposal). I'm not 100% for the ("HowTo") type name but can't think of a better one. Why don't I go ahead and merge it into the work-in-progress editor's draft webschemas.org site for review, so we can see how it looks? It'll need some careful review as there's a lot of Recipe markup out there... |
|
I'll aim to merge it within a day or so, but want to summarize the changes first (for docs/releases.html and review). There may be some naming changes e.g. could 'tool' be handled by our existing http://schema.org/instrument from the /Action vocabulary? |
|
OK, sounds good. Yes, "instrument" for "tool" also makes sense. |
|
Looking through this, a bit more caution. HowToAction is a subtype of ListItem. However in schema.org we have an extensive hierarchy of Action subtypes - I fear this could confuse. Would "HowToTask" work, perhaps? Similarly, both 'resource' and 'element' are words over-used in the underlying standards around schema.org (HTML, Microdata/json-ld/rdfa). I wonder if we can come up with alternate words here. @chaals any view? |
|
Dan, all, please take a look at the update. This introduces HowToDirection, removing any reference to Action. It removes "element" from HowToStep since it's already an ItemList and doesn't need another property for children. It also renames HowToResource to HowToSupply, replacing "resource" with "supply". It sets "supply" and "tool" to inherit from "instrument" but preserving the properties to distinguish between the consumable and non-consumed items used. "estimatedCost" accounts for only the former. Also, the first of these commits was amended and force-pushed to replace the inaccurate commit message. |
| </div> | ||
| <div> | ||
| <div> | ||
| Remove the hubcap and loosen the lug nuts. |
There was a problem hiding this comment.
Lots of people would say that you should do this before raising the tire off the ground. It's much harder if the wheel is spinning…
I would have moved this step earlier.
| <span property="rdfs:comment">A media object representing the circumstances before performing this direction.</span> | ||
| <span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/HowToDirection">HowToDirection</a></span> | ||
| <span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/MediaObject">MediaObject</a></span> | ||
| </div> |
There was a problem hiding this comment.
I'm not sure that beforeMedia and afterMedia are anything except apparent specialisations of duringMedia, at the first and last step...
Do we really need them?
There was a problem hiding this comment.
Just to clarify, they don't apply to the steps as a whole, they apply to a single direction in a single step.
Many instructions have multiple pictures for some of the steps (e.g. http://www.instructables.com/id/How-to-Make-a-Modern-Wooden-Clock/). However, the temporal connections between the pictures and the action are not specified (or specifiable). beforeMedia, duringMedia, and afterMedia solve this by enabling the author to annotate how things should look "before", "during" and "after" an action, respectively.
|
Noting @chaals comments, I am going to merge this into our release candidate. During the ~2 week release candidate review we can consider putting beforeMedia / afterMedia into the Pending area of schema.org. In general because this is so closely tied to the existing Recipe design it makes sense not to use Pending. Let's see how it is is received. |
|
@earljwagner et al., just wanted to follow up on beforeMedia / afterMedia, ... do you/we/anyone think these would still be useful? Can the same thing be expressed with existing vocabulary somehow? Any more tweaks or feedback on what we have so far? |
|
Just to clarify, they can't be expressed with the existing vocabulary and
they don't apply to the HowTo overall. For a single action described by a
HowToDirection (e.g. "hammer the nail into the wood"), beforeMedia shows
the circumstances before the action is performed (with the nail out of the
wood), and afterMedia shows after (with the nail in the wood).
If the comments don't make that clear, we may want to edit them.
…On Fri, Mar 2, 2018 at 2:46 PM, Dan Brickley ***@***.***> wrote:
@earljwagner <https://github.com/earljwagner> et al., just wanted to
follow up on beforeMedia / afterMedia, ... do you/we/anyone think these
would still be useful? Can the same thing be expressed with existing
vocabulary somehow? Any more tweaks or feedback on what we have so far?
—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
<#1616 (comment)>,
or mute the thread
<https://github.com/notifications/unsubscribe-auth/AAzSEDqaiyehHDBtekrvEIet4HLmuvkxks5tacvDgaJpZM4NV1rR>
.
--
From the personal email account of Earl J. Wagner at [email protected]
Please note: My incoming email is filtered into folders and I may not see
your email for several days.
Emails from accounts that send mass emails are filtered to a folder checked
about once per month.
If you'd like a faster response, text me a brief message on my cell at
773-960-1809
|
|
Shouldn't the "Expected Type" column contain |
4 participants
This is a continuation of the work started in #1087 and continued in #1517.
@danbri, @vholland, @robdodson, @dbiollo PTAL