Workspace

A Workspace is a Sparqdown Document whose body maintains a file-tree hierarchy of references to other Documents. Teams use Workspaces to give groups of docs a shared entry point: a new cook joins the Nordic Cuisine team, opens the Nordic Workspace, and navigates to onboarding docs, house recipes, safety standards — each of which is a Document in the Index.

Reference, not ownership

A Workspace never owns the documents it references. Two Workspaces may reference the same Document. Deleting a Workspace removes only the Workspace Document itself — every referenced doc is untouched.

Body vocabulary

  • sdg:workspaceRoot — declared once per Workspace body; its ordered children are the top-level folders and items.
  • sdg:folder — a named container. Has sdg:folderName and an ordered list of children (folders or items).
  • sdg:item — a reference to a Document. Carries:
  • sdg:referencesDocument <DocIRI> (required) — the Document being referenced
  • sdg:pinnedToVersion <VerIRI> (optional) — pin to a specific Version; default is "always latest"
  • sdg:displayName "…" (optional) — workspace-local display name override; the Document's canonical title stays unchanged

Mutations

Rename, reorder, add, or remove an item → publish a new Version of the Workspace Document. The current state of the hierarchy is always the latest published Version. Online edits in a running service stay in memory until restart; seeded Workspaces re-seed from the /docs corpus.

First-class queries

  • "All Documents in Workspace X": SELECT ?doc WHERE { <X> sdg:containsItem+ [ sdg:referencesDocument ?doc ] }
  • "All Workspaces containing Document X": SELECT ?ws WHERE { ?ws sdg:containsItem+ [ sdg:referencesDocument <X> ] }

Authoring

Phase 1 has no Workspace authoring UI — hand-author the Sparqdown body. The dedicated drag-and-drop surface ships in Phase 4+.

Workspace — Sparqdown Docs