Documentation

= The GoodRelations User's Guide =


 * 1) Quickstart (to be completed)
 * 2) What is GoodRelations?
 * 3) How to Read the User's Guide

'''II. Preliminaries''' (to be completed)
 * 1) Identifiers on the Web of Data: URIs
 * 2) Syntaxes for Data on the Web: RDFa, Microdata, and JSON-LD
 * 3) GoodRelations and Schema.org
 * 4) Useful Tools and Resources
 * 5) Conventions for Illustrations and Examples

'''III. GoodRelations Core Model''' (to be completed)
 * 1) Overview of 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) Structured Values and Value References
 * 5) Agent: Company or Person (gr:BusinessEntity)
 * 6) Promise: Offer (gr:Offering)
 * 7) Object: Product or Service (gr:ProductOrService, gr:SomeItems, gr:Individual)
 * 8) Compensation: Price Information
 * 9) Location: Store or Point of Sale (gr:Location)

'''IV. GoodRelations in Detail''' (to be completed)
 * 1) Opening Hours
 * 2) Product Features
 * 3) Bundles
 * 4) Options, Add-ons, Extensions
 * 5) Product Models
 * 6) Product Variants
 * 7) Consumables, Accessories, Spare Parts, and Similar Products
 * 8) GoodRelations and Product Ontologies
 * 9) Developing Extensions for Vertical Industries
 * 10) Explicating Demand: Wish-lists, Tendering, Interest to Buy
 * 11) Exposing Ownership: Global Shopping History
 * 12) Reviews
 * 13) Images and Logos
 * 14) 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

Leftovers
 * 1) Whetting Your Appetite: Adding GoodRelations to a Web Site for Google and other Search Engines
 * 2) Adding GoodRelations to Standard Web Shop Software
 * 3) Feature Comparison
 * 4) RDF, RDF/XML, RDFa, Microdata, and SPARQL
 * 5) Design Goals and Considerations
 * 6) GoodRelations vs. the Semantic Web, Linked Data, and the Opengraph Protocol
 * 7) The Single, Most Productive Way of Developing RDFa Markup
 * 8) GoodRelations in Microdata Syntax and in Combination with Schema.org