Skip to content
Source on GitHubVisitors

Time values and the other 0.2 forms

Example document time-values.did

It is explained in 10.2 Time values and the other 0.2 forms.

What it demonstrates

From 10.2 Time values and the other 0.2 forms:

This DID 0.2 definition was written with a small history specification, org.example.history, whose node type Era has start and stop of type yearMonth and an enum kind whose members declare stored forms, whose node type Event has at of type datetime with writtenPrecision: "preserve" and timezone: "floating", and whose relation type Influence declares its target end optional. Several things to notice:

  • yearMonth values are signed astronomical years with at least four digits: "-3200-01" is January 3201 BCE, "0000-01" is January 1 BCE.
  • at keeps the form each value was written in: full dates ("1450-01-01"), a date-time with an offset ("2026-09-30T09:00:00Z") and a local date-time ("2026-10-02T14:30"). A move of Review of this diagram writes the new value as a local date-time to the minute.
  • kind holds the enum's stored forms ("script", "book", "network"), not its member keys.
  • The relation inf_web_open has no target yet.
  • The second suppression names a subject, for a finding about something that is not drawn, instead of an element.

Views generated from the file

This view is drawn by this site from time-values.did itself. It shows the data in the document, not the notation the diagram draws.

Structure of time-values.did. Flowchart of the data in time-values.did: 8 elements (Era, Event) as boxes by type and id, and 2 relations (Influence) as arrows from source to target.
Generated from time-values.did at 10c1ea0
Diagram as text (Mermaid)
flowchart LR
  accTitle: Structure of time-values.did
  accDescr: Flowchart of the data in time-values.did: 8 elements (Era, Event) as boxes by type and id, and 2 relations (Influence) as arrows from source to target.
  era_cuneiform["Era<br/>era_cuneiform<br/>Cuneiform"]
  era_codex["Era<br/>era_codex<br/>Codex"]
  era_web["Era<br/>era_web<br/>World Wide Web"]
  ev_moveable_type["Event<br/>ev_moveable_type<br/>Moveable type in Mainz"]
  ev_proposal["Event<br/>ev_proposal<br/>Information management: a proposal"]
  ev_first_site["Event<br/>ev_first_site<br/>First website online"]
  ev_draft["Event<br/>ev_draft<br/>Draft of this diagram started"]
  ev_review["Event<br/>ev_review<br/>Review of this diagram"]
  era_codex -->|Influence| era_web
  era_web -->|Influence| undefined

The file

Download time-values.did (2,424 bytes, unchanged from the source).

{
  "$schema": "https://etalii.net/adp/did/schema/0.2/did.schema.json#/$defs/Definition",
  "did": "0.2",
  "language": { "id": "org.example.history", "version": "0.2.0" },
  "meta": { "createdAt": "2026-09-30T09:00:00Z", "modifiedAt": "2026-09-30T11:25:00Z", "generator": "Reference runtime 0.2" },
  "diagram": {
    "attributes": {
      "title": "Writing and the web",
      "from": "-3200-01",
      "to": "2026-12"
    }
  },
  "elements": [
    { "id": "era_cuneiform", "type": "Era",
      "attributes": { "name": "Cuneiform", "start": "-3200-01", "stop": "-0100-12", "kind": "script" } },
    { "id": "era_codex", "type": "Era",
      "attributes": { "name": "Codex", "start": "0000-01", "stop": "1450-12", "kind": "book" } },
    { "id": "era_web", "type": "Era",
      "attributes": { "name": "World Wide Web", "start": "1989-03", "stop": "2026-09", "kind": "network" } },
    { "id": "ev_moveable_type", "type": "Event",
      "attributes": { "name": "Moveable type in Mainz", "at": "1450-01-01" } },
    { "id": "ev_proposal", "type": "Event",
      "attributes": { "name": "Information management: a proposal", "at": "1989-03-12" } },
    { "id": "ev_first_site", "type": "Event",
      "attributes": { "name": "First website online", "at": "1991-08-06" } },
    { "id": "ev_draft", "type": "Event",
      "attributes": { "name": "Draft of this diagram started", "at": "2026-09-30T09:00:00Z" } },
    { "id": "ev_review", "type": "Event",
      "attributes": { "name": "Review of this diagram", "at": "2026-10-02T14:30" } }
  ],
  "relations": [
    { "id": "inf_codex_web", "type": "Influence", "source": "era_codex", "target": "era_web" },
    { "id": "inf_web_open", "type": "Influence", "source": "era_web",
      "attributes": { "note": "Not yet connected" } }
  ],
  "views": [
    {
      "id": "v_eras",
      "viewpoint": "main",
      "name": "Eras",
      "viewport": { "x": 0, "y": 0, "zoom": 1 },
      "nodes": {
        "ev_review": { "labels": { "name": { "dx": 0, "dy": -8 } } }
      },
      "edges": {}
    }
  ],
  "suppressions": [
    { "constraint": "eraOverlap", "element": "era_web",
      "reason": "The web era is still open.", "by": "editor@example.org", "at": "2026-09-30T11:20:00Z" },
    { "constraint": "sourcesCited", "subject": "bibliography",
      "reason": "The bibliography is kept outside this diagram.", "by": "editor@example.org", "at": "2026-09-30T11:22:00Z" }
  ]
}

In an IDE

No IDE host runs this example yet.