Merge pull request #75 from AMuetsch/fix_bibliography

Address review findings in bibliography.bib
OpenSimulationInterface · Jun 10, 2024 · cb2781b · cb2781b
2 parents c2bf773 + 5e69259
commit cb2781b
Show file tree

Hide file tree

Showing 3 changed files with 51 additions and 59 deletions.
diff --git a/content/contributing/creating_references.adoc b/content/contributing/creating_references.adoc
@@ -7,6 +7,17 @@ endif::[]
 
 When citing literature in the reference documentation, adhere to the following guidelines:
 
+* Refer to
+//#TODO add link to latest version when available xref:https://internal.pages.asam.net/asam-editorial-guide/editorial-guide-generator/editorialguide-asciidoc/latest/Editorial_guide.html[
+rule ASM-22 of the ASAM Editorial Guide
+//]
+for detailed guidelines.
+* In the text, cite sources using `cite:[<Key>]`, with <Key> being the unique key defined in the bibliography.bib.
+
+//Replaced by ASM-22, see #75
+////
+When citing literature in the reference documentation, adhere to the following guidelines:
+
 * All sources shall be primary sources. Sources like Wikipedia are not allowed.
 * OSI uses _APA style_ references from the American Psychological Association.
 * In the text, sources are cited using numbers in brackets.
@@ -69,3 +80,4 @@ More sample templates are available at https://apastyle.apa.org.
     optional double atmospheric_pressure = 1;
 }
 ----
+////
diff --git a/content/general_docs/bibliography.bib b/content/general_docs/bibliography.bib
@@ -1,87 +1,68 @@
 % Encoding: UTF-8
 
-@Book{fmi2.0,
-  publisher = {Modelica Association, Linköping, Sweden},
-  title = {Functional Mock-up Interface for Model Exchange and Co-Simulation 2.0.4},
-  year = {2022-11},
+@Standard{fmi2.0,
+  title = {__{Modelica Association}__, https://github.com/modelica/fmi-standard/releases/download/v2.0.4/FMI-Specification-2.0.4.pdf[__FMI 2.0.4__^], Functional Mock-up Interface for Model Exchange and Co-Simulation 2.0.4, __2022__}
 }
 
-@Book{fmi3.0,
-  publisher = {Modelica Association, Linköping, Sweden},
-  title = {Functional Mock-up Interface Specification 3.0.1},
-  year = {2023-07},
+@Standard{fmi3.0,
+  title = {__{Modelica Association}__, https://fmi-standard.org/docs/3.0.1[__FMI 3.0.1__^], Functional Mock-up Interface Specification 3.0.1, __2023__}
 }
 
-@Book{ssp1.0,
-  publisher = {Modelica Association, Linköping, Sweden},
-  title = {System Structure and Parameterization 1.0.1},
-  year = {2022-07},
+@Standard{ssp1.0,
+  title = {__{Modelica Association}__, https://ssp-standard.org/publications/SSP101/SystemStructureAndParameterization101.pdf[__SSP 1.0.1__^], System Structure and Parameterization 1.0.1, __2022__}
 }
 
-@Book{IEEE_754-2019,
-  title     = {IEEE Standard for Floating-Point Arithmetic},
-  publisher	= {International Organization for Standardization, Geneva, Switzerland},
-  year      = {2019},
+@Standard{IEEE_754-2019,
+  title = {https://ieeexplore.ieee.org/document/8766229[__IEEE 754-2019__^], IEEE Standard for Floating-Point Arithmetic}
 }
 
-@Book{iso23150,
-  publisher = {International Organization for Standardization, Geneva, Switzerland},
-  title     = {ISO 23150:2021 Road vehicles — Data communication between sensors and data fusion unit for automated driving functions — Logical interface},
-  year      = {2021-05},
-  }
+@Standard{iso23150,
+  title = {https://www.iso.org/standard/74741.html[__ISO 23150:2021__^], Road vehicles — Data communication between sensors and data fusion unit for automated driving functions — Logical interface}
+}
 
-@Book{iso8601,
-  publisher = {International Organization for Standardization, Geneva, Switzerland},
-  title     = {ISO 8601:2019 Data elements and interchange formats — Information interchange — Representation of dates and times},
-  year      = {2004-12},
+@Standard{iso8601,
+  title = {https://www.iso.org/iso-8601-date-and-time-format.html[__ISO 8601:2019__^], Date and time format }
 }
 
-@Book{iso8855,
-  publisher = {Deutsches Institut für Normung e.V., Berlin, Germany},
-  title     = {DIN ISO 8855:2013-11 Road vehicles - Vehicle dynamics and road-holding ability - Vocabulary},
-  year      = {2013-11},
+@Standard{iso8855,
+  title = {https://www.beuth.de/de/norm/din-iso-8855/170878818[__DIN ISO 8855:2013-11__^], Road vehicles - Vehicle dynamics and road-holding ability - Vocabulary}
 }
 
-@Book{opencrg,
-  publisher = {ASAM e.V.},
-  title     = {OpenCRG},
-  year      = {2020},
+@Standard{opencrg,
+  title = {https://www.asam.net/index.php?eID=dumpFile&t=f&f=3950&token=21a7ae456ec0eb0f9ec3aee5bae3e8c9ebaea140[__ASAM OpenCRG 1.2.0__^], __2020__}
 }
 
-@Book{opendrive,
-  publisher = {ASAM e.V.},
-  title     = {OpenDRIVE},
-  year      = {2020},
+@Standard{opendrive,
+  title = {https://www.asam.net/index.php?eID=dumpFile&t=f&f=4422&token=e590561f3c39aa2260e5442e29e93f6693d1cccd[__ASAM OpenDRIVE 1.7.0__^], __2021__}
 }
 
-@Book{openscenario,
-  publisher = {ASAM e.V.},
-  title     = {OpenSCENARIO},
-  year      = {2021},
+@Standard{openscenario,
+    title  = {https://www.asam.net/index.php?eID=dumpFile&t=f&f=4908&token=ae9d9b44ab9257e817072a653b5d5e98ee0babf8[__ASAM OpenSCENARIO 1.2.0__^], __2022__}
 }
 
-@Book{protobuf,
-  publisher = {https://developers.google.com/protocol-buffers/},
-  title     = {Protocol Buffers},
-  year      = {2008-07},
+@misc{protobuf,
+  title = {https://developers.google.com/protocol-buffers[Protocol Buffers^]},
+  note = {[viewed 2008-07]}
 }
 
-@Book{wiki_rotation_matrix,
-  publisher = {https://en.wikipedia.org/wiki/Rotation_matrix},
-  title     = {Rotation Matrix},
-  year      = {2022-01},
+@misc{wiki_rotation_matrix,
+  author = {{Wikipedia}},
+  title  = {https://en.wikipedia.org/wiki/Rotation_matrix[Rotation Matrix^]},
+  note   = {[viewed 2022-01]}
 }
 
-@Book{wiki_euler_angles,
-  publisher = {https://en.wikipedia.org/wiki/Euler_angles},
-  title     = {Euler Angles},
-  year      = {2022-01},
+@misc{wiki_euler_angles,
+  author = {{Wikipedia}},
+  title  = {{https://en.wikipedia.org/wiki/Euler_angles[Euler Angles^]},
+  note   = {[viewed 2022-01]}
 }
 
-@Book{reuper2020,
-  publisher = {Reuper},
-  title     = {Multi-Frequency GNSS Sensor Fusion With Quality Assessment for Automotive Applications.},
-  year      = {2020},
+@book{reuper2020,
+  author = {Reuper, Björn},
+  title = {Multi-Frequency GNSS Sensor Fusion With Quality Assessment for Automotive Applications},
+  address = {Darmstadt, Germany},
+  publisher = {Technische Universität},
+  year = {2020}
 }
 
 

diff --git a/content/index.adoc b/content/index.adoc
@@ -105,8 +105,7 @@ include::./general_docs/glossary.adoc[leveloffset=+1]
 
 
 [bibliography]
-== Bibliography
-bibliography::[]
+include::./general_docs/bibliography.adoc[leveloffset=+1]
 
 [appendix]
 == Release Notes