Update in docs

Author: Yauhenikapl

documentation/modules/ROOT/pages/datatypes.adoc

@@ -89,11 +89,12 @@ definition in the respective standards and an informative description of their v
 .3+| Miscellaneous types
 | `https://www.w3.org/TR/xmlschema11-2/#anyURI[xsd:anyURI]` | Absolute or relative https://en.wikipedia.org/wiki/Uniform_Resource_Identifier[URI]s and https://en.wikipedia.org/wiki/Internationalized_Resource_Identifier[IRI]s | 'http://example.org/', 'urn:samm:{example-ns}.myapplication:1.0.0#errorState' | {ok}
 | `https://www.w3.org/TR/curie/[samm:curie]` | Compact URI/IRI (well-known prefix + element name) | 'xsd:string', 'unit:hectopascal' | {ok}
-| `https://www.w3.org/TR/rdf11-concepts/#section-Graph-Literal[rdf:langString]` | Strings with language tags | "Hello"@en, "Hallo"@de. When using `rdf:langString`, a language tag *must always* be provided using the `@` syntax (e.g., `"Hello"@en`).
-
-Using a typed literal form such as `"Hello"^^rdf:langString` is *invalid* and *should cause* the model loading or validation to fail. | {ok}
+| `https://www.w3.org/TR/rdf11-concepts/#section-Graph-Literal[rdf:langString]` | Strings with language tags | "Hello"@en, "Hallo"@de. Note that this is written in RDF/Turtle syntax, and that only "Hello" and "Hallo" are the actual values. | {ok}
 |===
 
+NOTE: When using `rdf:langString`, a language tag *must always* be provided using the `@` syntax (e.g., `"Hello"@en`).
+Using a typed literal form such as `"Hello"^^rdf:langString` is *invalid* and *should cause* the model loading or validation to fail."
+
 The following types defined by the XSD and RDF specifications, respectively, are considered
 unsuitable in Aspect Models and _should not_ be used:
 

documentation/modules/ROOT/pages/modeling-guidelines.adoc

@@ -168,15 +168,14 @@ and value references that point to example values (i.e., references to instances
 In either case, the data type of the `samm:exampleValue` must be convertible to the effective data type defined by the Property's Characteristic.
 For example, if the Characteristic's `samm:dataType`
 is `xsd:int`, a value with the type `xsd:short` is also acceptable. Refer to section xref:datatypes.adoc#implicit-conversions[Implicit Conversions]
-for more details.
+for more details. | {nok}
+|===
 
 When using `rdf:langString`, a language tag *must always* be provided using the `@` syntax, for example:
 
-:x samm:exampleValue "Hello"@en ✔️
-:x samm:exampleValue "Hallo"@de ✔️
-:x samm:exampleValue "Hello"^^rdf:langString ❌ (invalid — missing language tag)
-| {nok}
-|===
+* `:x samm:exampleValue "Hello"@en` ✔️
+* `:x samm:exampleValue "Hallo"@de` ✔️
+* `:x samm:exampleValue "Hello"^^rdf:langString` ❌ (invalid — missing language tag)
 
 Example with Literal type: