Skip to content

Specifications

This directory contains normative specifications owned by the ETLantic ecosystem.

  • DTCS 3.0 Specification is the canonical transformation-semantics specification. Version 3.0.0 supersedes 2.0.0 and adds Rich Portable Analytics with dtcs.transform-plan/2 and independently claimable semantic-family profiles.
  • DTCS in this docs site summarizes the current authority and profile inventory for ETLantic readers.
  • Vendored DTCS 1.0 snapshot is retained only for historical comparison and must not be treated as current authority.
  • DPCS 1.0 Specification defines pipeline-contract semantics.
  • Portable Transformation IR records ETLantic's authoring and compiler requirements on top of published DTCS plan/profile semantics. The canonical models live in dtcs>=0.13; the ETLantic authoring API has shipped since 0.11, with portable compiler capabilities added through 0.14.

ODCS is an external standard and is not copied into this repository. See the ODCS Integration Guide for ETLantic's relationship with the upstream specification.

Normative Versus Integration Documentation

Normative specifications define contract meaning with requirement language such as MUST, SHOULD, and MAY.

Integration guides explain how ETLantic authors, loads, validates, generates, and references those contracts:

ETLantic implementation details must not silently redefine normative contract semantics.

The canonical current DTCS publication is DTCS SPEC.md. The vendored DTCS_SPEC.md supports local documentation navigation and may lag the publisher's latest revision; when they differ, the published DTCS repository is authoritative.

Publication history: