Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
Changes to 7.0 including fast track Coronavirus-related vocabulary #2490
We will add markup to support Coronavirus information sharing, targeted at local organizations who are already updating their sites with information. The intent is to capture with a bit more structure some of that information, and to establish a model that can be iteratively improved during the crisis response period.
There are also minor changes in other areas of schema.org such as our (already extensively discussed) treatment of online events.
I will publish 7.0 imminently and we can refine things from there, at an accelerated pace.
Small typo in Example 1 JSON-LD for https://schema.org/SpecialAnnouncement.
Line 8 is just a "
datePosted is now in the specification. Google's SDTT does not recognise it yet and throws a warning.
I'm working on an online editor to help people create this markup. Is this the best place to post any issues I see on the way?
I've built the first version of my Bing SpecialAnnouncements editor:
Most of my observations are about the Bing guidelines compared to the schema.org spec. What's the best place to send them feedback?
The Bing guidelines are a bit confusing with respect to what is required. Sections start with "The following properties represent the minimum information required to be present" and
Bing does not clarify if they support WebContent which is an option for many of the properties. All examples use URLs.
Bing implies they only support one entity in spatialCoverage, while the third example on https://schema.org/SpecialAnnouncement shows an array of them.
The second example in https://schema.org/SpecialAnnouncement for School Closures includes 'webFeed' and 'about' using School. Bings Guidelines does not state either of those properties. It does mention you can add more than stated.
Bings example on https://www.bing.com/webmaster/help/special-announcement-specifications-5cbd6249 includes a description for the DataDownload set to "Number of Individuals Tested".
@Tiggerito , the tool you put together looks great! I would love to hear from you if you get feedback from folks trying to use it so we can improve both schema.org and Bing's guidelines.
Re Bing's implementation, you can send feedback here, or, to save the mailing list since we usually focus on schema.org itself rather than the search engines' implementation of it, feel free to contact me directly at https://www.linkedin.com/in/tom-marsh-2183873/.
Thanks a lot for the detailed feedback on our post and docs.
I agree the sentence before the property table is confusing v. the required v. not-required labels in the table. I'll update the sentences to be clearer.
Yes, we would support WebContent, but we encouraged URLs instead. One reason was that we thought it would be easier to enter an existing URL showing the content v. copying the content itself. The bigger reason was that we expect it to be easier to verify that the announcement is about the same site on which it is posted if a URL is used v. WebContent.
We didn't mean to imply that spatialCoverage should be singular. I will update the documentation to be clearer on that.
On 'about', @danbri , should we recommend spatialCoverage instead in the schema.org example? It's not clear to me why we need about separately for school closures.
On 'webFeed', @danbri , it looks like webFeed is not currently allowed on SpecialAnnouncement, despite its use in the example. Shall we add it?
On "Number of Individuals Tested", that is the title of the table on https://www.doh.wa.gov/emergencies/coronavirus. The markup is just matching what is on the page. That said, the table above that ("Confirmed Cases / Deaths by County") is probably more interesting, so I'll update the example to that.
On the SDTT errors, @danbri , the tool doesn't recognize datePosted yet. I fixed most of the other errors and warnings and will update the snippet in the help docs accordingly.
One of my friend's clinic started COVID19 testing facilities. He is planning to display a special announcement area in all pages of his website to convey this to all his visitors. Where should I add the SpecialAnnouncement schema, in homepage or on all pages?
Thanks in advance,
Another minor example issue. Third example on https://schema.org/SpecialAnnouncement has ""Santa Clara County, CA" three times.
Several examples have name and text set to the same value. It there any benefit in doing that?
I'd also be interested in where people can best place this markup and make you aware that it exists.
I've updated my editor to cope with multiple spatialCoverage entities and to support all relevant types. And I've added more examples from the schema.org page.
@Tiggerito , I'm not sure I fully understand your question about the best place to put the markup. I guess in general, it's better to put markup on pages that get viewed/clicked in search results more often. Although it's certainly not the only criteria, more popular pages tend to get crawled more often, so the markup would be likely to be seen by search engines sooner.