Merge pull request #22 from admin-shell-io/issue/11

Issue/11

aas/1/0/README.md

@@ -1,6 +1,6 @@
 # AAS (Asset Administration Shell)
 
-This is the sub-namespace resevered for the Asset Administration Shell Metamodel. 
+This is the sub-namespace resevered for the Asset Administration Shell Metamodel version 1.0. 
 
 ## Introduction
 
@@ -53,4 +53,4 @@ If needed stakeholder specific views can be defined on the elements of the AAS.
 
 ## Contact
 
-This subnamespace was created by the [Plattform Industrie 4.0](https://www.plattform-i40.de/). The [Coordination Board Submodels](mailto:[email protected]) maintains these identifiers.
+This subnamespace was created by the [Plattform Industrie 4.0](https://www.plattform-i40.de/). The [Coordination Board Submodels](mailto:[email protected]) maintains these identifiers.

aas/1/README.md

@@ -0,0 +1,3 @@
+# AAS (Asset Administration Shell)
+
+This is the sub-namespace resevered for the [Asset Administration Shell Metamodel version 1](./0/README.md).

aas/2/0/1/README.md

@@ -0,0 +1,3 @@
+# Revision 2.0.1 of the AAS Metamodel
+
+tbc.

aas/2/README.md

@@ -1,5 +1,3 @@
-# AAS Metamodel Version 2
+# AAS (Asset Administration Shell)
 
-This location contains the revisions of the second version of the AAS Metamodel. Currently, two revisions are in place or will be published soon:
-- Release 2.0: Major release from 2019
-- Release 2.1: First revision as of 2020
+This is the sub-namespace resevered for the [Asset Administration Shell Metamodel version 2](./0/README.md).

aas/3/0/README.md

@@ -1,3 +1,7 @@
-# AAS  Release Candidate Version of Metamodel Version 3
-This location contains the revisions of the release candidate of the third version of the AAS Metamodel. Currently, one revision is in place or will be published soon:
-- Release 3.0RC01: Major release from 2020
+# AAS (Asset Administration Shell)
+
+This is the sub-namespace resevered for the Asset Administration Shell Metamodel version 3.0.
+
+
+## Status: `suggested`
+The sub-namespace AAS 3.0 and its identifiers are currently under development by the subworking group 'Asset Administration Shell'. See the [Candidate Release](./RC01/README.md) for further information.

aas/3/README.md

@@ -1,4 +1,7 @@
 # AAS Metamodel Version 3
 
-This location contains the revisions of the third version of the AAS Metamodel. Currently, one revision is in place or will be published soon:
-- Release 3.0RC01: Major release from 2020
+This location contains the revisions of the third version of the AAS Metamodel.
+Currently, one revision is in place as a Release Candidate. The major release
+version 3.0 will be published soon:
+
+- [Release 3.0.RC01](./0/RC01/): Release Candidate from 2020

aas/API/1/0/README.md

@@ -0,0 +1,9 @@
+# AAS (Asset Administration Shell)
+
+This is the sub-namespace resevered for the Asset Administration Shell - Part 2 Interoperability at Runtime Version 1.0.
+
+The document 'Details of the Asset Administration Shell Part 2 - Interoperability at Runtime' [1] defines the meaning of its content and the used identifiers.
+
+[1] S. Bader, B. Berres, B. Boss, A. Graf Gatterburg, M. Hoffmeister et al.
+['Details of the Asset Administration Shell Part 2, Interoperability at Runtime – Exchanging Information via Application Programming Interfaces'](), Version 1.0RC02,
+Plattform Industrie 4.0, ZVEI, 2021

aas/API/1/README.md

@@ -0,0 +1,9 @@
+# AAS (Asset Administration Shell)
+
+This is the sub-namespace resevered for the [Asset Administration Shell - Part 2 Interoperability at Runtime ](./0/README.md).
+
+The document 'Details of the Asset Administration Shell Part 2 - Interoperability at Runtime' [1] defines the meaning of its content and the used identifiers.
+
+[1] S. Bader, B. Berres, B. Boss, A. Graf Gatterburg, M. Hoffmeister et al.
+['Details of the Asset Administration Shell Part 2, Interoperability at Runtime – Exchanging Information via Application Programming Interfaces'](), Version 1.0RC02,
+Plattform Industrie 4.0, ZVEI, 2021

aas/API/README.md

@@ -0,0 +1,9 @@
+# AAS (Asset Administration Shell)
+
+This is the sub-namespace resevered for the [Asset Administration Shell - Part 2 Interoperability at Runtime Version 1.0](./1/0/README.md).
+
+The document 'Details of the Asset Administration Shell Part 2 - Interoperability at Runtime' [1] defines the meaning of its content and the used identifiers.
+
+[1] S. Bader, B. Berres, B. Boss, A. Graf Gatterburg, M. Hoffmeister et al.
+['Details of the Asset Administration Shell Part 2, Interoperability at Runtime – Exchanging Information via Application Programming Interfaces'](), Version 1.0RC02,
+Plattform Industrie 4.0, ZVEI, 2021

aas/README.md

@@ -1,6 +1,39 @@
 # AAS
 
-Sub-namespace for the AAS Metamodel. Currently, two major revisions have been published:
-- Release 1 from 2018
-- Release 2 from 2019
-- Release 3 from 2020
+Sub-namespace for the AAS Metamodel. The Metamodel is defined in a series of
+publications, the ``Details of the Asset Administration Shell'', composed of
+three parts:
+* Part 1 contains the core classes and attributes, and a set of standardized
+serializations.
+* Part 2 defines the APIs as well as the  access and manipulation methods with
+AAS components
+
+As of April 2022, two major versions of Part 1 have been published, while the
+third is currently finalized:
+- [Release 1](/aas/1/0/README.md) from 2018 [1]
+- [Release 2](/aas/2/0/README.md) from 2019 [2]
+- [Revision 2.0.1](/aas/2/0/1/README.md) from May 2020 [3]
+- [Candidate Release of version 3.0](./3/0/RC01/README.md) 2020 [4]
+
+Part 2 will be released in [Version 1](./API/1/0/README.md) before the end of 2022.
+
+
+[1] B. Boss, M. Hoffmeister, T. Deppe, F. Pethig, E. Barnstedt et al.
+['Details of the Asset Administration Shell Part 1, The exchange of information
+between partners in the value chain of Industrie 4.0'](), Version 1.0,
+Plattform Industrie 4.0, ZVEI, 2018
+
+[2] B. Boss, M. Hoffmeister, T. Deppe, F. Pethig, S. Bader, E. Barnstedt et al.
+['Details of the Asset Administration Shell Part 1, The exchange of information
+between partners in the value chain of Industrie 4.0'](), Version 2.0,
+Plattform Industrie 4.0, ZVEI, 2019
+
+[3] B. Boss, M. Hoffmeister, T. Deppe, F. Pethig, S. Bader, E. Barnstedt et al.
+'Details of the Asset Administration Shell Part 1, The exchange of information
+between partners in the value chain of Industrie 4.0', Version 2.0.1,
+Plattform Industrie 4.0, ZVEI, 2020
+
+[4] B. Boss, M. Hoffmeister, T. Deppe, F. Pethig, S. Bader, E. Barnstedt et al.
+['Details of the Asset Administration Shell Part 1, The exchange of information
+between partners in the value chain of Industrie 4.0'](https://www.plattform-i40.de/IP/Redaktion/EN/Downloads/Publikation/Details_of_the_Asset_Administration_Shell_Part1_V3.html), Version 3.0.RC01,
+Plattform Industrie 4.0, ZVEI, 2020