W3C home > Mailing lists > Public > public-vocabs@w3.org > September 2013

Re: Semantically marking up a "checklist" or process

From: Martin Hepp <martin.hepp@ebusiness-unibw.org>
Date: Wed, 11 Sep 2013 18:57:58 +0200
Cc: Jason Douglas <jasondouglas@google.com>, Jarno van Driel <jarno@quantumspork.nl>, Dan Brickley <danbri@google.com>, Guha Guha <guha@google.com>, TallyFy <hello@tallyfy.com>, PublicVocabs <public-vocabs@w3.org>, Vicki Tardif Holland <vtardif@google.com>, Sam Goto <goto@google.com>
Message-Id: <0DC6CCE4-0A8D-4332-956E-AE5B11F7ED79@ebusiness-unibw.org>
To: Justin Boyan <jaboyan@google.com>
Hi Justin:
On Sep 11, 2013, at 5:51 PM, Justin Boyan wrote:

> The current proposal is ambiguous about whether the ListItem is the item itself, or whether the ListItem.represents is the item.
> Here are two options which I think would be clearer:

> Option 1. Make the range of itemListElement be Thing.  Create a new StructuredValue called NumberedItem which pairs a Number and a Thing.

The ListItem is the ListItem ;-) Actually, it is the same as the NumberedItem type you propose below. If you want to model an entity linked to the list item (i.e. a song, artist, place, ...), then you can define that externally or within the list.

We could broaden the range of itemListElement to Thing so that a list can contain three types of entries:

a) untyped, pure text entries (as it is in the current version)
b) a structured value that holds a position and a link to another entity (my original proposal) or
c) any other entity without an order (basically your proposal; but then it becomes a unordered list).

> With this schema, representing a list without numbers can be done with a flat model:
> 
> { "@context" : "http://schema.org",
>   "@type" : "ItemList",
>   "itemListElement" : [ {"@type" : "Movie", "name" : "Jaws"}, {"@type" : "Movie", "name" : "Bulworth"} ] }
> 
Note that this list has not deterministic order. While JSON-LD and Microdata carry an order of the elements in the syntax, the order can be lost when the data is translated by RDF tooling.

> And the extra hierarchy only comes into play when numbers are required:
> 
> { "@context" : "http://schema.org",
>   "@type" : "ItemList",
>   "itemListElement" : [ {"@type" : "NumberedItem", "number" : 1, "item" : {"@type" : "Movie", "name" : "Jaws"}},
>                         {"@type" : "NumberedItem", "number" : 2, "item" : {"@type" : "Movie", "name" : Bulworth"}} ] }
> 
> 
This does not work, because you assign the number to the item instead of assigning it to the item in the context of the list.

> Option 2. Add a new property for the item position directly to schema.org/Thing. Call it, say, "rank" -- maybe it finds some other general applications besides item lists.
> 
> { "@context" : "http://schema.org",
>   "@type" : "ItemList",
>   "itemListElement" : [{"@type" : "Movie", "rank" : 1, "name" : "Jaws"}, {"@type" : "Movie", "rank": 2, "name" : "Bulworth"}] }
> 
> 
> What do you think? I think I prefer Option 1.
> 
This has the same problem.

In fact, as far as I can see, the original proposal caters for all of these cases, except for the case where you want an unordered list.

Martin

> Justin
> 
> 
> 
> 
> 
> On Wed, Sep 11, 2013 at 11:34 AM, Martin Hepp <martin.hepp@ebusiness-unibw.org> wrote:
> >
> > My question was about *numbered* unstructured steps... which I think is actually the use case that started the thread.
> >
> Then I ListItem.name should do the trick.
> 
> >
> >
> > Martin
> >
> >
> > --------------------------------------------------------
> > martin hepp
> > e-business & web science research group
> > universitaet der bundeswehr muenchen
> >
> > e-mail:  hepp@ebusiness-unibw.org
> > phone:   +49-(0)89-6004-4217
> > fax:     +49-(0)89-6004-4620
> > www:     http://www.unibw.de/ebusiness/ (group)
> >          http://www.heppnetz.de/ (personal)
> > skype:   mfhepp
> > twitter: mfhepp
> >
> > Check out GoodRelations for E-Commerce on the Web of Linked Data!
> > =================================================================
> > * Project Main Page: http://purl.org/goodrelations/
> >
> >
> >
> >
> 
> --------------------------------------------------------
> martin hepp
> e-business & web science research group
> universitaet der bundeswehr muenchen
> 
> e-mail:  hepp@ebusiness-unibw.org
> phone:   +49-(0)89-6004-4217
> fax:     +49-(0)89-6004-4620
> www:     http://www.unibw.de/ebusiness/ (group)
>          http://www.heppnetz.de/ (personal)
> skype:   mfhepp
> twitter: mfhepp
> 
> Check out GoodRelations for E-Commerce on the Web of Linked Data!
> =================================================================
> * Project Main Page: http://purl.org/goodrelations/
> 
> 
> 
> 

--------------------------------------------------------
martin hepp
e-business & web science research group
universitaet der bundeswehr muenchen

e-mail:  hepp@ebusiness-unibw.org
phone:   +49-(0)89-6004-4217
fax:     +49-(0)89-6004-4620
www:     http://www.unibw.de/ebusiness/ (group)
         http://www.heppnetz.de/ (personal)
skype:   mfhepp 
twitter: mfhepp

Check out GoodRelations for E-Commerce on the Web of Linked Data!
=================================================================
* Project Main Page: http://purl.org/goodrelations/
Received on Wednesday, 11 September 2013 16:58:25 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:29:31 UTC