Skip to content

docs: assess industrial maritime and power descriptions - #2061

Merged
Brad-Edwards merged 1 commit into
devfrom
2059-domain-description-design
Nov 15, 2026
Merged

Brad-Edwards merged 1 commit into
devfrom
2059-domain-description-design

Conversation

@Brad-Edwards

Copy link
Copy Markdown
Collaborator

Summary

Compare controller, navigation-computer and power-equipment descriptions with existing SDL contracts. Reuse recursive realization semantics and identify the minimum optional vocabulary, public attachment and addressability additions.

Requirement UIDs

  • (none — bug/refactor/maintenance run; see Traceability section below)

Related Issues

Closes #2059

ADR Impact

  • ADR-105 (preserved)
  • ADR-021

Changes

  • Map standards concepts to current fields, typed profiles, external concept bindings and references.
  • Add positive/refusal examples, trust boundaries and a data flow diagram while preserving author-selected detail and backend choices.
  • Keep the delivery design-only: no new SDL syntax, equipment inventory, schemas or adapters.

Test Plan

  • Full completion suite required in CI before merge
  • Repository policy checks required in CI before merge (documentation/workflow guardrails)
  • Unit tests / integration tests: N/A — docs-only change

10 targeted semantic test cases passed. Changed-path docs-prose (Vale and shared STE), file-local repository policy, relative links and git diff --check passed. Review found one repeated helper-path error; both references were corrected and the supported import verified. User accepted the review cap after repairs. Source assessment: 1f4d05e; starting evidence also checked at 33c09e9. IEC comparison uses its public abstract plus public ENTSO-E examples; no complete conformance claim. No executable changes or mutation tests.

Ground Control Checks

  • Repository policy checks required in CI before merge
  • Pre-push Codex review completed; all findings fixed or dispositioned

Traceability

Checklist

  • Code follows the project's coding standards
  • Changelog: owned by Release Please (generated from the Conventional Commit PR title; no per-PR fragment)
  • Architectural docs updated if stack, package structure, or key behaviors changed

Documentation

Updated: see diff.

@Brad-Edwards
Brad-Edwards added this pull request to the merge queue Nov 15, 2026
Merged via the queue into dev with commit 3eb5790 Nov 15, 2026
38 checks passed
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