feat(docs): Migrate version info (#532)

Signed-off-by: Maximilian Rosin <maximilian.rosin@parson-europe.com>

Author: max-rosin

doc/open-simulation-interface_user_guide.adoc

@@ -114,8 +114,22 @@ include::./misc/osi_reference.adoc[leveloffset=+1]
 
 == Releases and compatibility
 
+include::./releases/versioning.adoc[leveloffset=+2]
+
 include::./releases/releases.adoc[leveloffset=+2]
 
-include::./releases/versioning.adoc[leveloffset=+2]
+include::./releases/v02.00.adoc[leveloffset=+3]
+
+include::./releases/v02.01.adoc[leveloffset=+3]
+
+include::./releases/v02.02.adoc[leveloffset=+3]
+
+include::./releases/v03.00.adoc[leveloffset=+3]
+
+include::./releases/v03.01.adoc[leveloffset=+3]
+
+include::./releases/v03.02.adoc[leveloffset=+3]
+
+include::./releases/v03.03.adoc[leveloffset=+3]
 
-include::./releases/compatibility.adoc[leveloffset=+2]
+//include::./releases/compatibility.adoc[leveloffset=+2]

doc/releases/releases.adoc

@@ -1,11 +1,3 @@
 = Releases
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
-Et malesuada fames ac turpis egestas.
-Mauris pharetra et ultrices neque ornare aenean euismod elementum nisi.
-Nulla facilisi morbi tempus iaculis urna id. Justo eget magna fermentum iaculis.
-Sed augue lacus viverra vitae congue eu.
-Velit ut tortor pretium viverra suspendisse.
-Amet commodo nulla facilisi nullam vehicula ipsum a.
-Nibh nisl condimentum id venenatis a.
-Diam vel quam elementum pulvinar etiam non quam lacus suspendisse.
+ss

doc/releases/v02.00.rst doc/releases/v02.00.adocdoc/releases/v02.00.rst renamed to doc/releases/v02.00.adoc

@@ -1,25 +1,25 @@
-`v2.0.0 - OSI Initial Commit <https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v2.0.0>`_
-============================
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v2.0.0[v2.0.0 - OSI Initial Commit]
+
 
 This is the initial version of the Open Simulation Interface (OSI).
 
-Overview:
------------
+== Overview
+
 OSI is a generic interface for the environmental perception of automated driving functions in virtual scenarios. It is primarily conceived to enable easy and straightforward compatibility between automated driving functions and the variety of driving simulation frameworks available. The data description has been derived from the perspective of sensor modeling for automated test and validation of highly automated driving functions.
 
-Implementation:
-----------------
-OSI primarily contains an object based environment description using the message format of the protocol buffers library developed and maintained by Google.
+== Implementation
 
-Detailed description:
----------------------
+OSI primarily contains an object based environment description using the message format of the protocol buffers library developed and maintained by Google.
 
-**Top level interfaces**:
-OSI consists of two individual top level interfaces for object data: The ``OSI::GroundTruth`` and the ``OSI::SensorData`` interface.
+== Detailed description
 
 
-- The ``OSI::GroundTruth`` interface provides an exact view on the simulated objects in a global coordinate system. This message is populated using the internally available data of the used (driving)-simulation framework and is afterwards published to external subscribers with an exporter plugin.
-- The ``OSI::SensorData`` interface describes the objects in the reference frame of a sensor for environmental perception. It is generated from a ``OSI::GroundTruth`` message and can either be used to directly connect to an automated driving function using ideal simulated data, or may serve as input for a sensor model simulating limited perception as a replication of real world sensor behavior.
+Top level interfaces::
+OSI consists of two individual top level interfaces for object data: The ``OSI::GroundTruth`` and the ``OSI::SensorData`` interface.
++
+* The ``OSI::GroundTruth`` interface provides an exact view on the simulated objects in a global coordinate system. This message is populated using the internally available data of the used (driving)-simulation framework and is afterwards published to external subscribers with an exporter plugin.
+* The ``OSI::SensorData`` interface describes the objects in the reference frame of a sensor for environmental perception. It is generated from a ``OSI::GroundTruth`` message and can either be used to directly connect to an automated driving function using ideal simulated data, or may serve as input for a sensor model simulating limited perception as a replication of real world sensor behavior.
 
-**Low level interfaces**:
+Low level interfaces::
++
 Additionally to the two top level interfaces, OSI contains an ``OSI::LowLevelData`` message. This message describes the output of a (physical) model of the measurement process before tracking and object hypothesis. It does not deal with object data, but may comprise the geometrical influence of 3D simulations e.g. generating Lidar point clouds with a ray-tracer plugin. In addition this message supports generic radar reflection lists and will be extended to supporting low level camera data in the future.

doc/releases/v02.01.adoc

@@ -0,0 +1,12 @@
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v2.1.0[v2.1.0 - OSI "Agile Andretti"]
+
+== Purpose
+
+This is the initial BASE VERSION for Tool Development.
+
+https://github.com/OpenSimulationInterface/open-simulation-interface/milestone/1?closed=1[Content/Changes]
+
+== Remarks
+
+We will now release the versions using the name of a https://en.wikipedia.org/wiki/List_of_Formula_One_drivers[Formula 1 driver]!
+Naming convention: "adjective + last name driver" -> Alliteration necessary!

doc/releases/v02.01.rst

@@ -0,0 +1,26 @@
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v2.2.0[v2.2.0 - OSI "Brave Brabham"]
+
+== Purpose
+
+This release focuses on optimizing the build process and documentation.
+
+== https://github.com/OpenSimulationInterface/open-simulation-interface/milestone/2?closed=1[Content/Changes]
+
+* Added a shared library target to the CMake build script.
+* Generated a proper doxygen documentation.
+* Placed the version number in one file (VERSION).
+* Added unit testing mechanism including style guide checking.
+* Redefined precipitation and added a fog definition to the environmental conditions message.
+* Added layer id to low level point cloud data.
+* Reworked large parts of the build instructions in the WIKI.
+
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v2.2.1[v2.2.1 - OSI "Brave Brabham", Update 1]
+
+== Purpose
+
+This release focuses on optimizing the build process and ensures the proper installation of different versions of OSI on a single system.
+
+== https://github.com/OpenSimulationInterface/open-simulation-interface/compare/maintenance/v2.2.x[Content/Changes]
+
+* Allowing several OSI versions on the same computer.
+* Improves CI builds to also test the installation cmake targets for proper completion.

doc/releases/v02.02.adoc

@@ -0,0 +1,56 @@
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v3.0.0[v3.0.0 - OSI "Cosmic Coulthard"]
+
+== Purpose
+
+This release is a complete rework including the feedback from many OSI users. Thank you!
+We are aligned with the ongoing discussions for the upcoming ISO 23150 standard for hardware sensor outputs in order to bring simulation and the hardware in the car closer together.
+
+https://github.com/OpenSimulationInterface/open-simulation-interface/pulls?page=1&q=is%3Apr+is%3Aclosed+milestone%3Av3.0.0[Content/Changes]
+
+* Added major version to package label (osi3), allowing concurrent use of OSI 2.x and OSI 3.x in one process.
+* Added new top-level messages (new concept SensorView (Configuration),etc.).
+** GroundTruth.
+** SensorView.
+** SensorData / FeatureData.
+** SensorViewConfiguration (used for auto-configuration of SensorView).
+* Added technology-specific SensorView sub-messages to aid physical models.
+* Introduced conceptual separation of “SensorModels” and “LogicModels”.
+* Extended enumerations (e.g. traffic sign Type according to StVO, vehicle Type, etc.).
+* Improved messages and definitions (additional RoadConditions, country code in GT, AmbientIllumination, etc.).
+* Use ISO 8855 coordinate systems (incompatible with earlier OSI versions).
+* Redefined DetectedXXX messages.
+* Introduced DetectedStationaryObjects.
+* Merged MovingObjects and Vehicle messages.
+* Redefined Lane messages (with separated lane boundary messages and intersections).
+* Redefined TrafficLight messages.
+* Redefined TrafficSigns (1 x MainSign + n x SupplementarySign inclusive BaseStationary).
+* New FeatureData messages (rework of previous LowLevelData message) - aligned with an upcoming standard ISO 23150.
+* FeatureData usable for fusion units.
+* Extension and clarification of the existing doxygen documentation.
+* Improved doxygen collaboration diagrams.
+* Build process improvements, added install targets.
+* Made proto definitions compatible with proto3 restrictions to allow concurrent use with proto3-only implementations in the future.
+* Fixed version-checking of transmitted data.
+* AND MUCH MORE ENJOY!!!
+
+https://github.com/OpenSimulationInterface/open-simulation-interface/files/2297162/osi_overview_v2.2_vs_v3.0.pdf>[See for more information the `changelog`]
+
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v3.0.1[v3.0.1 - OSI "Cosmic Coulthard", Update 1]
+
+https://www.youtube.com/watch?v=yG0oBPtyNb0[Summertime :)]
+
+== Purpose
+
+This release is a patch reworking parts of the documentation in order to avoid ambiguities and improving the build/installation process of OSI.
+
+https://github.com/OpenSimulationInterface/open-simulation-interface/pulls?page=1&q=is%3Apr+is%3Aclosed+milestone%3Av3.0.1[Content/Changes]
+
+* Added script to automatically convert the messages from proto2 to proto3 with on the wire compatibility
+* cmake enhancements to enable multi-version support of OSI 2 and OSI 3
+* Added Python 3 support
+* Clarification of multiple comments
+* Added explanatory images in the documentation
+* centerline definition improved
+* signal_strength definition in LidarSensorView corrected
+* FeatureData::ambiguity_id definition clarified
+* RadarSensorViewConfiguration::AntennaDiagram::response definition clarified

doc/releases/v02.02.rst

@@ -0,0 +1,33 @@
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v3.1.0[v3.1.0 - OSI "Dynamic Duncan"]
+
+https://www.youtube.com/watch?v=fu3uA8K6ApQ>[(O SI)lent night]
+
+== Purpose
+
+This time of the year Santa comes with presents and has also thought about the sensor modelers of this planet. We introduce the current state of the ISO 23150 discussions including Ultrasonic and Camera Detections. The traffic signs have been reworked and the documentation has been extended for a perfect user experience. Trust me - it's amazing!
+
+== https://github.com/OpenSimulationInterface/open-simulation-interface/pulls?q=is%3Apr+is%3Aclosed+milestone%3Av3.1.0>[Content/Changes]
+
+* Complete rework of traffic signs including images in documentation.
+* Added Camera Detections in osi_featuredata.proto.
+* Added Ultrasonic Detections in osi_featuredata.proto.
+* Introduced light states for emergency and service vehicles.
+* Added orientation_acceleration and updated formulas.
+* Extended documentation with svg images.
+* Added model_reference for static and moving objects.
+* Added map_reference in ground truth.
+* Added proj4 string for coordinate transformations.
+* Introduced raster_lidar_proposal from innoviz.
+* Improved documentation with HTML tables and images for all traffic signs.
+
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v3.1.1[v3.1.1 - OSI "Dynamic Duncan", Update 1]
+
+== https://github.com/OpenSimulationInterface/open-simulation-interface/pulls?q=is%3Apr+is%3Aclosed+milestone%3Av3.1.1[Content/Changes]
+
+* **Bug Fix**: Changed open_simulation_interface target back from being a static library to a shared library, as before (this reverts an inadvertent change in v3.1.0 from previous releases). v3.1.0 breaks all users of the shared library (i.e. everyone building on Linux/Unix systems, and even some using the DLL on Windows).
+
+= https://github.com/OpenSimulationInterface/open-simulation-interface/releases/tag/v3.1.2[v3.1.2 - OSI "Dynamic Duncan", Update 2]
+
+== https://github.com/OpenSimulationInterface/open-simulation-interface/pulls?q=is%3Apr+is%3Aclosed+milestone%3Av3.1.2[Content/Changes]
+
+* **Bugfix**: The version number is now correct in the VERSION file.