Merge pull request #32 from admin-shell-io/BiBo/fixes

Improve description of changes

Author: aorzelskiGH

documentation/IDTA-01004/modules/ROOT/pages/access-rule-model.adoc

@@ -221,20 +221,13 @@ The list element is written with [] to express, that $match shall check if a cer
 [[text-serialization-of-values-of-type-reference]]
 ==== Text Serialization of Values of Type Reference
 
+References are used in ReferenceAttributes, IdentifiableObjects, ReferableObjects, FragmentObjects and DescriptorObjects for the corresponding ReferenceLiterals, IdentifiableLiterals, ReferableLiterals, FragmentLiterals and DescriptorLiterals.
+
 ====
-Note: V3.1 will include more detailed grammar definitions for <ReferenceAttribute>, <IdentifiableObject>, <ReferableObject>, <FragmentObject> and <DescriptorObject>.
+Note: V3.1 will include a more detailed grammar for defining <ReferenceAttribute>, <IdentifiableObject>, <ReferableObject>, <FragmentObject> and <DescriptorObject>.
 See Change Notes for further details.
 ====
 
-References are used in ReferenceAttributes, IdentifiableObjects, ReferableObjects, FragmentObjects and DescriptorObjects for the corresponding ReferenceLiterals, IdentifiableLiterals, ReferableLiterals, FragmentLiterals and DescriptorLiterals.
-
-Such references use the link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/mappings/mappings.html#reference-serialization[Part 1 Mapping in Section "Text Serialization of Values of Type Reference"] for specific instances of elements, e.g. an AAS, a Submodel, a ConceptDescription or a specific SubmodelElement.
-
-Access Rules may also be defined for all Identifiables of the Keytypes AssetAdministrationShell, Submodel or ConceptDescription.
-In this case an IdentifiableLiteral uses the format "(AssetAdministrationShell)\*", "(Submodel)*" and "(ConceptDescription)*".
-
-Access Rules extend the Keytypes of Part 1 by "(aasDesc)" for AAS Descriptors and "(smdesc)" for submodel descriptors.
-To define all descriptors "(aasDesc)\*" or "(smdesc)*" may be used in DescriptorLiterals accordingly.
 
 [[json-serialization]]
 == JSON Serialization of Access Rule Model

documentation/IDTA-01004/modules/ROOT/pages/annex/text-access-rule-examples.adoc

@@ -61,6 +61,7 @@ include::partial$examples/bpn.bnf[]
 include::partial$examples/allow-read-all-users-of-company-for-submodel.bnf[]
 ----
 
+[[allow-read-submodels-id-pattern]]
 == Allow READ to all Submodels with ID pattern for all authenticated users of a company for submodels with Nameplate and TechnicalData from 9:00-17:00
 
 [source,bnf,linenums]

documentation/IDTA-01004/modules/ROOT/pages/changelog.adoc

@@ -8,22 +8,29 @@ SPDX-License-Identifier: CC-BY-4.0
 
 ////
 
+[[change-notes]]
 = Change Notes
 
-== Changes w.r.t. V3.0 to V3.0.1
+== Changes w.r.t. V3.0.1 vs. V3.0
 
 Major Changes:
 
-* changed: Removed whitespaces from several clauses and fixed an issue with the idShortPath definition in the BNF Grammar for the Query Language [#477](https://github.com/admin-shell-io/aas-specs-api/issues/477).  
+* changed: Removed whitespaces from several clauses [#477](https://github.com/admin-shell-io/aas-specs-api/issues/477)
+* fixed idShortPath definition in the BNF Grammar for the Query Language 
+* changed:  xref:access-rule-model.adoc#text-serialization-of-values-of-type-reference[text serialization of Reference]  does not follow text serialization of Part 1 of References, the updated grammar will be added in the V3.1, proposal see below
+
 
 Minor Changes:
 
-* Correct Example in Annex
+* correct xref:annex/text-access-rule-examples.adoc#allow-read-submodels-id-pattern[example] in Annex
+* remove <FieldIdentifierString> in grammar and use <FieldIdentifier> directly
 
 Proposed changes for V3.1:
 
 The following grammar changes are proposed for V3.1 and will be explained in detail then.
 
+[source,json,linenums]
+----
 <ReferenceAttribute>
 ::= "REFERENCE(" (
 ("$aas" <IdentifierInstance> "#" <FieldsAAS> )
@@ -67,5 +74,5 @@ The following grammar changes are proposed for V3.1 and will be explained in det
 "DESCRIPTOR" <ws>
 ("$aasdesc" | "$smdesc")
 <IdentifierInstanceOrAll>
-
+----