Skip to content

docs: announce planned Apache Ossie support#991

Open
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/3eb36d6a
Open

docs: announce planned Apache Ossie support#991
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/3eb36d6a

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Adds a new page under Build your semantic layer stating that Lightdash will support Apache Ossie (Incubating), the open specification for semantic layer and ontology interchange.

  • New page: guides/apache-ossie.mdx
    • Explains what Ossie is (project-only framing, no dbt Labs history)
    • Maps Ossie concepts (semantic model, dataset, relationship, field, metric, AI context, custom extensions) to their Lightdash equivalents
    • Describes planned support: import Ossie models into Lightdash, export Lightdash projects as Ossie, round-trip via custom_extensions
    • Summarizes the direction Ossie is heading (richer metric semantics, semantic query language + reference engine, catalog/ontology integration, richer field metadata and tooling) at a high level, without quoting spec details or roadmap items
  • Adds the page to the "Build your semantic layer" group in docs.json

Requested by Ian in Slack, followed up by Winnie.


Generated by Mintlify Agent.

Requested by: ian@lightdash.com via Slack
Mintlify session: slack_1783978780.633919_C0AM8D5UUR5

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 guides/business-user-training-outcomes-checklist.mdx

Comment thread guides/apache-ossie.mdx Outdated
| AI context | Descriptions, [AI hints, and verified content](/references/writing-descriptions) |
| Custom extensions | Model-level `meta` / configuration extensions |

The overlap is close enough that Lightdash semantic models can be expressed in Ossie's format, and Ossie models authored elsewhere can be mapped onto Lightdash's model. Where the two differ today, Ossie is a portable interchange format while Lightdash is a full query engine, catalog, and UI on top of the semantic layer.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mintlify remove this

Comment thread guides/apache-ossie.mdx Outdated
Comment on lines +37 to +40
- **Import** an Ossie semantic model into a Lightdash project so its datasets, relationships, dimensions, and metrics show up as queryable content, with descriptions and AI context preserved.
- **Export** a Lightdash project (whether defined via dbt or [Lightdash YAML](/guides/lightdash-yaml)) as an Ossie semantic model, so other Ossie-compatible tools and AI agents can consume the same definitions.
- **Round-trip** models between Lightdash and other Ossie-compatible tools without losing meaning, using Ossie's `custom_extensions` mechanism to carry Lightdash-specific configuration that isn't part of the core spec.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull this out — roll the sentence above and below into a conclusion to the last section below below the table: we plan to support it, the spec's evolving.

We need to do some research before we commit to a specific functionality.

Comment thread guides/apache-ossie.mdx Outdated
Comment on lines +47 to +51
- A more expressive core model — richer metric semantics, explicit grain and entity modeling, more capable relationship definitions, and reusable semantic filters.
- A standardized semantic query language and reference engine, so consumers (BI tools, AI agents, APIs) can query any Ossie-compatible semantic layer through a consistent interface.
- Catalog integration and semantic services, making Ossie models discoverable and governable at the platform layer (for example, alongside Apache Polaris).
- An ontology layer that describes business concepts independently of physical tables, enabling conceptual — not just structural — interoperability across models.
- Richer field semantics (units, currencies, PII classification, display metadata) and better tooling (validators, converters) around the spec.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a lot of this is repetitive, tighten this to 3 key points

Comment thread guides/apache-ossie.mdx Outdated
- An ontology layer that describes business concepts independently of physical tables, enabling conceptual — not just structural — interoperability across models.
- Richer field semantics (units, currencies, PII classification, display metadata) and better tooling (validators, converters) around the spec.

We'll evolve Lightdash's Ossie support in step with these directions, prioritizing the pieces that unlock better interoperability, AI grounding, and governance for Lightdash customers.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Kill this sentence it adds no new info

@mintlify

mintlify Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Jul 13, 2026, 10:27 PM

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 guides/business-user-training-outcomes-checklist.mdx

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 guides/business-user-training-outcomes-checklist.mdx

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