Skip to content
Ocean-Atlasv0.1.0Canonical Knowledge

Tag DSL Reference

1. Overview

Section titled “1. Overview”

A tag is a free-form label attached to one DSL item, used to classify it by concern, ownership, lifecycle, visibility, or another tooling-defined category.

Tags are one of two generic metadata mechanisms Ocean DSL items may declare, the other being perspectives (see dsl.perspective).

2. Normative Definition

Section titled “2. Normative Definition”

The complete syntax, placement, and validation rules for tags are defined by dsl.metadata, Section 3 (“Tags”). This document does not duplicate that specification; consult dsl.metadata as the single normative source.

The canonical keyword is plural and prefixed: @tags. The legacy singular spelling tag is not canonical DSL syntax.

3. Minimal Example

Section titled “3. Minimal Example”
NotificationFlow
    @tags : messaging, core, external

See dsl.metadata for the full item-level placement rules, validation requirements, and a complete worked example.

Section titled “4. Related Knowledge”
  • DSL Metadata — normative definition of @tags, @perspectives, and file-level group.
  • Perspective — the companion key-value metadata mechanism.
  • Vault — supports item-level tags.
  • Broker — supports item-level tags.
  • Dashboard — supports item-level tags.

The primary semantic relationships are declared in the document metadata.