continued work on documentation

Signed-off-by: pasched <[email protected]>

Author: pasched

general_docs/conventions.adoc

@@ -1,13 +1,9 @@
 = Conventions
 
-== Naming Conventions
-
-In this document, the following conventions apply:
-
 == Units
 
 Every field has its own unit that is defined in the proto files.
-For more information, see <<_commenting_on_fields_and_enums, the example in the contribution guidelines.>>)
+For more information, see <<_commenting_on_fields_and_enums, the example in the contribution guidelines.>>
 
 [#sec-273d9649-afab-45d3-b6c9-73c0e64971a0]
 == Modal verbs

general_docs/deliverables.adoc

@@ -0,0 +1,8 @@
+= Deliverables
+
+The following deliverables are provided for {THIS_STANDARD}:
+
+* User guide (overall scope, partly normative)
+* .proto files (normative)
+* Doxygen reference documentation (not normative)
+* OSMP packaging (OSMP packaging has its own version number, but is compatible with the version of {THIS_STANDARD}.)

general_docs/deliverables_and_standard

@@ -3,16 +3,12 @@
 {THIS_STANDARD} is an open-source standardization project.
 OSI and its supporting tools are developed publicly on GitHub.
 
-The source code and documentation for OSI and OSI-related tools are spread over several repositories.
+The source code and documentation for OSI and OSI-related tools are spread over several repositories:
 
 open-simulation-interface:: Main repository containing the interface description based on Google's Protocol Buffers, including helper scripts and test scripts.
 
 osi-documentation:: Source for the OSI user guide.
 
 osi-sensor-model-packaging:: Packaging specification for OSI models used in FMI 2.0 cite:[fmi2.0] simulation environments, including examples.
 
-osi-validation:: Source code and documentation for the OSI Validator, a CLI tool for validating OSI messages.
-
-osi-visualizer:: Source code and documentation for the OSI Visualizer, a GUI tool for visualizing OSI messages.
-
 proto2cpp:: Doxygen filter for creating the reference documentation from OSI .proto files.

general_docs/osi_repos.adoc

@@ -48,6 +48,8 @@ include::./general_docs/foreword.adoc[leveloffset=+1]
 
 == Introduction
 
+include::./general_docs/deliverables.adoc[leveloffset=+2]
+
 include::./general_docs/osi_repos.adoc[leveloffset=+2]
 
 include::./general_docs/statements.adoc[leveloffset=+2]