MJ Suhonos mjsuhonos

Records, Documents, & Graphs (II)

On the need for running code and rough consensus.

If you want to make the Semantic Web a reality, stop making the case for it and spend your time doing something more useful, like actually making machines smarter or helping people publish data in a way that’s useful to them. Manu Sporny, "JSON-LD and Why I Hate the Semantic Web" --21 Jan 2014

Context

This document is an attempt to bring together several parallel discussions that revolve around the lack of a shared understanding on how to represent RDF resources in relation to the (pre-existing) concepts of records, documents, objects, and graphs. In particular:

	{
	"@context": {
	"as": "http://www.w3.org/ns/activitystreams#",
	"bibo": "http://purl.org/ontology/bibo/",
	"cc": "http://creativecommons.org/ns#",
	"cwrc": "http://www.cwrc.ca/ontologies/cwrc#",
	"dbpedia": "http://dbpedia.org/resource/",
	"dc": "http://purl.org/dc/terms/",
	"dcterms": "http://purl.org/dc/terms/",
	"doap": "http://usefulinc.com/ns/doap#",

	[
	{
	"@context": {
	"edm": "http://www.europeana.eu/schemas/edm/",
	"ladder": "Ladder:",
	"skos": "http://www.w3.org/2004/02/skos/core#"
	},
	"@type": [
	"edm:Agent"
	],

	[
	{"module":"DPLA",
	"name":"Agent",
	"vocabs": ["RDF::EDM","RDF::SKOS"],
	"types": ["edm:Agent"],
	"aliases": {"name":"skos:prefLabel"}
	},
	{"module":"DPLA",
	"name":"Aggregation",
	"vocabs": ["RDF::EDM","RDF::ORE","RDF::DPLA"],

	{
	_b0: {
	_model: 'Resource',
	_types: ['schema:CreativeWork'],
	dc: {
	DDC: ['subject[@authority="ddc"]', :_b1],
	LCC: ['subject[@authority="lcc"]', :_b2],
	LCSH: ['subject[@authority="lcsh"]', :_b3],
	RVM: ['subject[@authority="rvm"]', :_b4],
	abstract: 'abstract',

	StepStool has a few convenience actions:

	- ladder:init will delete all existing data (including files) and re-initialize your account
	- index:init will delete the index but retain all mapped objects; it will NOT rebuild the index
	- index:reindex will rebuild the index in real-time (ie. will not delete it first)
	- index:query will query the index and return a response in JSON

	Ladder will respond to several REST endpoints that aren't documented in StepStool. These are:

	GET /resources - list all resources (paged using &page and &per_page)