The GoodRelations User's Guide

Work in progress: The new GoodRelations User's Guide is still under development, so many pages shown below are currently just placeholders with little content. In the meantime, you can use the 2008 version of the GoodRelations primer, available at http://www.heppnetz.de/projects/goodrelations/primer/.

I. Quickstart (to be completed)

1. What is GoodRelations?
2. Whetting Your Appetite: Adding GoodRelations to a Web Site for Google and other Search Engines
3. Adding GoodRelations to Standard Web Shop Software
4. Feature Comparison

II. Preliminaries (to be completed)

1. Design Goals and Considerations
2. GoodRelations vs. the Semantic Web, Linked Data, and the Opengraph Protocol
3. RDF, RDF/XML, RDFa, Microdata, and SPARQL
4. Understanding the New Role of URIs for Data Markup
5. The Single, Most Productive Way of Developing RDFa Markup
6. GoodRelations in Microdata Syntax and in Combination with Schema.org
7. Tool Recommendations for Developers

III. GoodRelations in Depth (to be completed)

1. Understanding the Conceptual Model
2. Representing Quantitative Values (Examples: 220 volts, 5 to 10 miles, 5400 rpm)
3. Representing Qualitative Values and Enumerations (Examples: Garment sizes, product colors, plug types)
4. Offer (gr:Offering)
5. Company or Person (gr:BusinessEntity)
6. Store or Point of Sale (gr:Location)
7. Opening Hours
8. Product or Service (gr:ProductOrService, gr:SomeItems, gr:Individual)
9. Product Features
10. Pricing
11. Bundles
12. Options, Add-ons, Extensions
13. Product Models
14. Product Variants
15. Structured Values and Value References
16. Consumables, Accessories, Spare Parts, and Similar Products
17. GoodRelations and Product Ontologies
18. Developing Extensions for Vertical Industries
19. Explicating Demand: Wish-lists, Tendering, Interest to Buy
20. Exposing Ownership: Global Shopping History
21. Reviews
22. Images and Logos
23. Geo Data

IV. Publishing GoodRelations Data (to be completed)

1. Overview
2. RDFa and Microdata
3. Linked Data
4. SPARQL Endpoints
5. Combined Multiple Formats
6. Sitemaps, Semantic Sitemaps, and Dumps
7. Spreading the Word: Ping Services and Search Engine Submission
8. Access Control

V. Consuming GoodRelations Data (to be completed)

1. Overview
2. Finding Offers
3. Finding Product Model Master Data
4. Finding Stores
5. Matchmaking

VI. Annex (to be completed)

1. Popular UN/CEFACT Common Codes for Units of Measurement