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 GMT
This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:45:30 GMT