- From: Martin Hepp (UniBW) <martin.hepp@ebusiness-unibw.org>
- Date: Wed, 13 Aug 2008 09:19:24 +0200
- To: Story Henry <henry.story@bblfish.net>
- CC: semantic-web at W3C <semantic-web@w3c.org>
- Message-ID: <48A28AFC.8040303@ebusiness-unibw.org>
Dear Henry, Thanks for the suggestions! We will implement them when polishing and reformatting the primer shortly. Martin Story Henry wrote: > 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 Wednesday, 13 August 2008 07:20:05 UTC