diff --git a/specifications/operations/actor_create.yaml b/specifications/operations/actor_create.yaml
index 29619068..61d3a9fe 100644
--- a/specifications/operations/actor_create.yaml
+++ b/specifications/operations/actor_create.yaml
@@ -6,7 +6,6 @@ tags:
   - ACTOR
 parameters:
   - $ref: ../parameters/header/Prefer.yaml
-  # FIXME: missing header openEHR-AUDIT_DETAILS.committer
 requestBody:
   description: |
     The ACTOR.
diff --git a/specifications/schemas/demographic/Actor.yaml b/specifications/schemas/demographic/Actor.yaml
index 396aa25d..f85f9d24 100644
--- a/specifications/schemas/demographic/Actor.yaml
+++ b/specifications/schemas/demographic/Actor.yaml
@@ -10,7 +10,6 @@ properties:
     items:
       $ref: ../data_types/UDvText.yaml
   roles:
-    #for the API roles are embedded in the actor
     type: array
     items:
       $ref: Role.yaml
diff --git a/specifications/schemas/demographic/Address.yaml b/specifications/schemas/demographic/Address.yaml
index 47e80620..fbf5b3a1 100644
--- a/specifications/schemas/demographic/Address.yaml
+++ b/specifications/schemas/demographic/Address.yaml
@@ -4,5 +4,4 @@ allOf:
   - $ref: ../common/Locatable.yaml
 properties:
   details:
-    # FIXME: I don't know which item structure schema to use, there are 3 options
     $ref: ../data_structures/UItemStructure.yaml
diff --git a/specifications/schemas/demographic/Capability.yaml b/specifications/schemas/demographic/Capability.yaml
index 0ce6c433..782e2e67 100644
--- a/specifications/schemas/demographic/Capability.yaml
+++ b/specifications/schemas/demographic/Capability.yaml
@@ -6,7 +6,6 @@ required:
   - credentials
 properties:
   credentials:
-    # FIXME: I don't know which item structure schema to use, there are 3 options
     $ref: ../data_structures/UItemStructure.yaml
   time_validity:
     $ref: ../data_types/DvIntervalOfDate.yaml
diff --git a/specifications/schemas/demographic/Party.yaml b/specifications/schemas/demographic/Party.yaml
index 7ac6eeee..bc3d532c 100644
--- a/specifications/schemas/demographic/Party.yaml
+++ b/specifications/schemas/demographic/Party.yaml
@@ -4,7 +4,6 @@ allOf:
   - $ref: ../common/Locatable.yaml
 properties:
   details:
-    # FIXME: I don't know which item structure schema to use, there are 3 options
     $ref: ../data_structures/UItemStructure.yaml
   identities:
     type: array
diff --git a/specifications/schemas/demographic/PartyIdentity.yaml b/specifications/schemas/demographic/PartyIdentity.yaml
index f8f14c23..2c305922 100644
--- a/specifications/schemas/demographic/PartyIdentity.yaml
+++ b/specifications/schemas/demographic/PartyIdentity.yaml
@@ -4,5 +4,4 @@ allOf:
   - $ref: ../common/Locatable.yaml
 properties:
   details:
-    # FIXME: I don't know which item structure schema to use, there are 3 options
     $ref: ../data_structures/UItemStructure.yaml