Documentation

= The GoodRelations User's Guide =

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