adding some notes

Author: sebastian-iancu

development/composer.json

@@ -2,6 +2,7 @@
     "name": "openehr/specifications-tools-openapi",
     "description": "Tools to manage openEHR OpenApi specifications.",
     "type": "project",
+    "license": "Apache-2.0",
     "require": {
         "php": ">=7.4",
         "ext-json": "*",

specifications/schemas/base_types/ObjectRef.yaml

@@ -1,4 +1,6 @@
 # Note: This type codegen is failing around collision on property names _type vs type.
+# see: https://github.com/OpenAPITools/openapi-generator/issues/9444
+# see: https://github.com/OpenAPITools/openapi-generator/issues/8291
 # TODO: fix this as soon as redoc and/or openapi generator is able to coop with such names and distinguish the discriminator for real property
 title: OBJECT_REF
 type: object