Skip to content

Add gist ontology layer and improve template documentation#1

Merged
snapsynapse merged 1 commit intomainfrom
cc/cool-hypatia-7a6cbf
Apr 19, 2026
Merged

Add gist ontology layer and improve template documentation#1
snapsynapse merged 1 commit intomainfrom
cc/cool-hypatia-7a6cbf

Conversation

@snapsynapse
Copy link
Copy Markdown
Owner

  • Add optional gist semantic layer (enabled by default): @type annotations on JSON API items, context.jsonld at api/v1/, and ontology attribution block in index.json; disable with ontology.enabled: false in project.yml
  • Fix schema and data bugs: document source_file field, correct source_file paths in mapping/index.yml (container/ -> frameworks/), fix title: -> name: in CONTRIBUTING.md and VERIFICATION.md frontmatter examples
  • Clarify secondary entity role in project.yml (inline/mapping-defined, not standalone files)
  • Add validate.js error reference table to README
  • Add MCP tool naming derivation table to README
  • Improve .gitignore comment to explain Option A vs B for forks
  • Sharpen Quick Start: fork vs clone distinction, specific first edit guidance, success signal for build step
  • Add live demo link and "What it produces" section before examples
  • Add ASCII data-flow diagram showing project.yml + data -> build -> docs
  • Add "What to keep" callout in Replacing example data section
  • Trim README Verification section to pointer; consolidate duplicate config prose in VERIFICATION.md

- Add optional gist semantic layer (enabled by default): @type annotations
  on JSON API items, context.jsonld at api/v1/, and ontology attribution
  block in index.json; disable with ontology.enabled: false in project.yml
- Fix schema and data bugs: document source_file field, correct source_file
  paths in mapping/index.yml (container/ -> frameworks/), fix title: -> name:
  in CONTRIBUTING.md and VERIFICATION.md frontmatter examples
- Clarify secondary entity role in project.yml (inline/mapping-defined,
  not standalone files)
- Add validate.js error reference table to README
- Add MCP tool naming derivation table to README
- Improve .gitignore comment to explain Option A vs B for forks
- Sharpen Quick Start: fork vs clone distinction, specific first edit
  guidance, success signal for build step
- Add live demo link and "What it produces" section before examples
- Add ASCII data-flow diagram showing project.yml + data -> build -> docs
- Add "What to keep" callout in Replacing example data section
- Trim README Verification section to pointer; consolidate duplicate
  config prose in VERIFICATION.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@snapsynapse snapsynapse merged commit 30881b5 into main Apr 19, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant