Documentation

= The GoodRelations User's Guide =

The new GoodRelations User's Guide is still under development.

In the meantime, you can use the 2008 version of the GoodRelations primer, available at


 * http://www.heppnetz.de/projects/goodrelations/primer/

I. Quickstart

 * 1) What is GoodRelations?
 * 2) Adding GoodRelations to your site
 * 3) Minimal Example for Google and Yahoo and Facebook
 * 4) Adding GoodRelations to standard Web shop software
 * 5) Feature Comparison

II. Preliminaries

 * 1) Design Goals and Considerations
 * 2) GoodRelations vs. the Semantic Web, Linked Data, and the Opengraph Protocol
 * RDF, RDF/XML, RDFa, and SPARQL
 * 1) Understanding the new role of URIs for data markup
 * 2) The single, most productive way of developing RDFa markup
 * 3) Tool Recommendations for Developers

III. GoodRelations in Depth

 * 1) Understanding the Conceptual Model
 * 2) Offer (gr:Offering)
 * 3) Company or Person (gr:BusinessEntity)
 * 4) Store or Point of Sale (gr:Location)
 * 5) Opening Hours
 * 6) Product or Service (gr:ProductOrService, gr:SomeItems, gr:Individual)
 * 7) Pricing
 * 8) Bundles
 * 9) Options, Add-ons, Extensions
 * 10) Product Models
 * 11) Consumables, Accessories, Spare Parts, and Similar Products
 * 12) GoodRelations and Product Ontologies
 * 13) Explicating Demand: Wishlists, Tendering, Interest to Buy
 * 14) Exposing Ownership - Global Shopping History
 * 15) Access Control
 * 16) Reviews
 * 17) Images and Logos
 * 18) Geo Data

IV. Publishing GoodRelations Data

 * 1) Overview
 * 2) Only RDFa
 * 3) Only RDF/XML
 * 4) SPARQL Endpoints
 * 5) Combining RDFa and RDF/XML
 * 6) Sitemaps, Semantic Sitemaps, and Dumps
 * 7) Spreading the Word: Ping Services and Search Engine Submission

V. Consuming GoodRelations Data

 * 1) Overview
 * 2) Offers
 * 3) Model master data
 * 4) Stores
 * 5) Matchmaking

VI. ANNEX

 * 1) Popular UN/CEFACT Common Codes for Units of Measurement