S
semantic.ioBETA
Open Source — github.com/NickEubanks/semantic-io-content

Contribute to the Glossary

semantic.io is an open source reference built by practitioners across every industry that intersects with semantic AI. You do not need to be a software engineer — if you know the domain, you can contribute.

Add a New TermReport an ErrorView on GitHub

What You Can Contribute

◈

New term

A concept not yet in the glossary

⟁

Definition improvement

Deeper explanation, better examples, clearer language

◎

Factual correction

Fix an error with a source citation

⊞

New source

Add a credible reference to an existing term

≋

Category fix

Correct a miscategorised term

⇌

Related terms

Add or remove cross-links between terms

How to Contribute

A

GitHub Web Editor — no setup required

  1. 1. Navigate to glossary/ in the repo.
  2. 2. Click Add file → Create new file for a new term, or click an existing file and the pencil icon to edit.
  3. 3. Use _template.md as your starting point.
  4. 4. Fill in the frontmatter and body following the schema below.
  5. 5. Scroll to Commit changes, write a brief description, and choose Create a new branch and start a pull request.
  6. 6. Submit — the editorial team reviews within 5 business days.
Open Web Editor →
B

Local Fork — for larger contributions

git clone https://github.com/YOUR_USERNAME/semantic-io-content.git
cd semantic-io-content
git checkout -b add/your-term-slug
cp glossary/_template.md glossary/your-term-slug.md
# Edit the file, then:
git add glossary/your-term-slug.md
git commit -m "Add: Your Term Name"
git push origin add/your-term-slug
# Open a pull request on GitHub

Content Schema

Every term lives in glossary/<slug>.md with this frontmatter:

---
term: "Semantic Layer"
slug: "semantic-layer"
shortDef: "A translation layer between raw data and business logic."
category: "Core Infrastructure"
relatedTerms:
  - "ontology"
  - "knowledge-graph"
sources:
  - title: "W3C OWL Overview"
    url: "https://www.w3.org/TR/owl-features/"
contributors:
  - "your-github-username"
lastUpdated: "2026-04-01"
---

Valid Categories

Core InfrastructureAI ApplicationsAI FoundationsAI ArchitectureAI StandardsData GovernanceData EngineeringData ArchitectureInfrastructureStandards & Languages

Editorial Standards

01

Accuracy

Claims must be verifiable. Every term requires at least one credible source — W3C spec, peer-reviewed paper, official documentation, or widely-cited industry report.

02

Neutrality

Definitions must be vendor-neutral. Do not promote specific products or services.

03

Completeness

All required frontmatter fields must be present and valid. The shortDef must be 160 characters or fewer.

04

Clarity

The shortDef must be understandable by a technical professional outside the field. Start with plain English, then introduce precision.

05

Originality

Content must be original. Do not copy-paste from Wikipedia, vendor documentation, or LLM outputs without substantial rewriting.

Review Process

  1. 1

    A maintainer reviews your PR within 5 business days.

  2. 2

    Feedback is left as inline comments on the PR.

  3. 3

    Once approved, the term is merged and appears on semantic.io within 24 hours.

Questions?

Not sure if your term fits? Unsure about the schema? Open a GitHub Discussion or email the editorial team.

Open a GitHub DiscussionEmail nick@semantic.io