Re: Examples in the LDP primer

Regarding what the Spec says about Things vs. Documents-about-Things ... I think we are little vague. 
Maybe this is intentional, but my feeling is that it would be better if we were more transparent.

Roger



On 14 Dec 2013, at 15:29, Nandana Mihindukulasooriya wrote:

> Hi Henry,
> 
> First of all, the examples in the primer will definitely change to reflect the changes that we are discussing in the WG at the moment but we will wait until we get the WG consensus and whatever resolutions are incorporated to the spec. If we try to adapt examples while the discussions are ongoing, that would leads to too much extra work.
> 
> On Sat, Dec 14, 2013 at 2:01 PM, Henry Story <henry.story@bblfish.net> wrote:
> >  <bugs/> a bt:BugCollection;
> >       bt:hasBugs <1>, ...., <300000>.
> 
> [[ aside for Primer writers:
> minor tweak. Your <1>, ...., <30000> are information resources, so they are documents. And so your
> repository is one of bug reports. Bug Reports are things I imagine can change from being bugs, to being feature
> requests etc... Bugs themselves on the other hand can be duplicates of other bugs. So you can have less bugs than
> bug reports.
> 
> We discussed this a lot in the mailing list and the first examples of the primer do not make the distinction between the information resource and the bug by intention and not because we are confused. It was to keep the examples as simpler as possible. I think everyone in the WG understands that the BugReport/Bug or ProductDescription/Product are not the same thing and they can have properties that might have different values for creator, createdData, licence, copyrights, etc. 
> 
> However, the idea was not to make the examples look more complex than necessary specially to the Web developers who would like to get a grasp of LDP and are not aware about this http range 14 issue. The idea was to introduce the distinction between the information resource and the thing it represent in a later example (Example 3.1) in the primer. As you think the information resource and the thing it represent should always be given separate identifiers and that distinction should always be made explicit, there are set of people who think it can be kept simpler when that distinction is not very important in their use cases.  For example, in the URLs-in-Data [1], they say that it is a decision of the publisher to decide how distinct those two are and model accordingly. Either way, once we have the consensus on three or two new types of containers, we will organize the examples in the primer accordingly and the examples covering SimpleContainer will provide a good starting point. If you still think that all the examples in the primer should make that distinction explicit, we can do a straw-poll in the mailing list or proposal in a telco and modify the spec according to the result. 
>  
>  Furthermore bt:hasBugs sounds like a relation from one to many, whereas in RDF it is a relation from
> one to one - so the relation should really be bt:hasBugReport .
> 
> We agree on this and the property used in the Primer "hasBug" from day one not "hadBugs".
> 
> Best Regards,
> Nandana
> 
> [1] - http://www.w3.org/TR/urls-in-data/#landing-pages