From f37666b52f2403cf2708f730be1260d4913dbc92 Mon Sep 17 00:00:00 2001
From: aorzelskiGH <andreas@orzelski.de>
Date: Fri, 17 Apr 2026 17:22:32 +0200
Subject: [PATCH] docs(access-rule-model): reference cross-spec terminology
 matrix

Add a NOTE in the grammar introduction that explicitly maps each
FieldIdentifier prefix ($aas / $sm / $sme / $cd / $aasdesc /
$smdesc) to the corresponding Metamodel class (IDTA-01001) and
API resource path (IDTA-01002). References the new normative
terminology matrix in IDTA-01001 as the single source of truth
and states that prefixes are lower-case only.

Refs: Review Finding T-09
Made-with: Cursor
---
 .../IDTA-01004/modules/ROOT/pages/access-rule-model.adoc     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/documentation/IDTA-01004/modules/ROOT/pages/access-rule-model.adoc b/documentation/IDTA-01004/modules/ROOT/pages/access-rule-model.adoc
index 82e4493..5dbe9e4 100644
--- a/documentation/IDTA-01004/modules/ROOT/pages/access-rule-model.adoc
+++ b/documentation/IDTA-01004/modules/ROOT/pages/access-rule-model.adoc
@@ -46,6 +46,11 @@ The symbol FieldIdentifier allows to use attributes of
 AAS, Submodel, SubmodelElement, ConceptDescription, AAS-Descriptor and Submodel-Descriptor. 
 Depending on the type of repository or registry such attributes are allowed or not.
 
+[NOTE]
+====
+The FieldIdentifier prefixes `$aas`, `$sm`, `$sme`, `$cd`, `$aasdesc` and `$smdesc` correspond directly to the Metamodel classes `AssetAdministrationShell`, `Submodel`, `SubmodelElement`, `ConceptDescription`, `AssetAdministrationShellDescriptor` and `SubmodelDescriptor`, and to the API resources `/shells`, `/submodels`, `.../submodel-elements/{idShortPath}`, `/concept-descriptions`, `/shell-descriptors` and `/submodel-descriptors` respectively. The normative cross-specification mapping is given in the "Terminology Across IDTA-01001, IDTA-01002 and IDTA-01004" section of IDTA-01001 (AAS Metamodel). All prefixes are lower-case; variants such as `$aasDesc` or `$SmDesc` MUST be rejected by conforming parsers.
+====
+
 
 The AAS Query Language and the AAS Access Rules share the same BNF grammar for formula expressions.
 In addition to the text below, the further details of the formula expressions are explained in  link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01002/v3.1/query-language.html[IDTA-01002, Query Language] .