Skip to content
Ocean-Atlasv0.1.0Canonical Knowledge

Perspective DSL Reference

1. Overview

Section titled “1. Overview”

A perspective is context-dependent, key-value metadata attached to one DSL item, used to describe variants or views consumed by tooling — for example version, lifecycle stage, region, or channel.

Perspectives are one of two generic metadata mechanisms Ocean DSL items may declare, the other being tags (see dsl.tag).

2. Normative Definition

Section titled “2. Normative Definition”

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

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

3. Minimal Example

Section titled “3. Minimal Example”
NotificationFlow
    @perspectives : channel:email, region:US

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

Section titled “4. Related Knowledge”
  • DSL Metadata — normative definition of @tags, @perspectives, and file-level group.
  • Tag — the companion free-form label metadata mechanism.
  • Vault — supports item-level perspectives.
  • Broker — supports item-level perspectives.
  • Context — supports item-level perspectives.

The primary semantic relationships are declared in the document metadata.