W3C home > Mailing lists > Public > semantic-web@w3.org > August 2008

Re: ANN: GoodRelations - The Web Ontology for E-Commerce

From: Story Henry <henry.story@bblfish.net>
Date: Tue, 12 Aug 2008 06:32:26 +0200
Cc: semantic-web at W3C <semantic-web@w3c.org>
Message-Id: <E2C20EB8-5CA1-4B66-A2EE-4804BF8AE2B3@bblfish.net>
To: martin.hepp@unibw.de
Very nice.

Just a small stylistic note on the primer. You could make the primer  
more readable by trying to indent the  N3 a bit better.  Currently you  
have example such as

default:Offering_1
a gr:Offering ;
gr:hasBusinessFunction
gr:Sell ;
gr:hasPriceSpecification
default:UnitPriceSpecification_1 ;
gr:includesObject default:TypeAndQuantityNode_1 .

The above uncessarily difficult to read. It requires a good  
understanding of N3 syntax, which one should not yet assume to be  
widespread, to understand. For example one has to know the meaning of  
';'. A bit more indentation, and keeping the property value pairs  
together would be good.

The html is a bit odd for you examples, as each line is made to be a  
paragraph.

The construct I would use is rather

<pre>
  <code>
default:Offering_1
     a gr:Offering ;
     gr:hasBusinessFunction gr:Sell ;
     gr:hasPriceSpecification default:UnitPriceSpecification_1 ;
     gr:includesObject default:TypeAndQuantityNode_1 .
  </code>
</pre>

The <pre> tag means that your lines are preformatted, so the  
whitespaces and end of lines are already marked. The <code> piece  
gives some hint as to the type of entity that is inside.

Henry

On 11 Aug 2008, at 11:22, Martin Hepp wrote:

>
> 1. Project page
> http://purl.org/goodrelations/
> 2. Ontology
> http://purl.org/goodrelations/v1
> 3. Specification (via client-side rendering)
> http://purl.org/goodrelations/v1
> 3. User's Guide
> http://www.heppnetz.de/projects/goodrelations/primer/



Received on Tuesday, 12 August 2008 04:33:33 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 21:45:24 GMT