Apply suggestions from code review

Author: pmai

doc/spec/basic_conventions.adoc

@@ -33,4 +33,9 @@ The model may have inputs, outputs, and parameters that are not specified by OSM
 Alternatively a model can be packaged as a valid FMU for co-simulation as specified in the FMI 3.0 standard cite:[fmi3.0].
 In this case, unless otherwise noted, all specifications in the FMI 3.0 cite:[fmi3.0] standard apply as-is.
 
-The provisions above for FMI 2.0 apply, with the provision that the annotation shall be placed into the `<Annotations>` element of the `modelDescription.xml`.
+The rules above for FMI 2.0 apply, with the provision that the annotation shall be placed as an `<Annotation>` element into the `<Annotations>` element of the `modelDescription.xml`:
+
+[source,xml]
+----
+<Annotation type="net.pmsf.osmp" xmlns:osmp="http://xsd.pmsf.net/OSISensorModelPackaging"><osmp:osmp version="1.4.0" osi-version="x.y.z"/></Annotation>
+----

doc/spec/binary_variables.adoc

@@ -87,7 +87,7 @@ The actual binary variable shall contain an annotation of the following form in
 
 [source,xml]
 ----
-<Tool name="net.pmsf.osmp" xmlns:osmp="http://xsd.pmsf.net/OSISensorModelPackaging"><osmp:osmp-binary-variable name="<prefix>" role="full" mime-type="<mime-type>"/></Tool>
+<Annotation type="net.pmsf.osmp" xmlns:osmp="http://xsd.pmsf.net/OSISensorModelPackaging"><osmp:osmp-binary-variable name="<prefix>" role="full" mime-type="<mime-type>"/></Annotation>
 ----
 
 `<prefix>` is the prefix as defined above.