Suggestions for changes to the "Writing OpenSCENARIO scenarios" section
I suggest
-
to rename the section "Writing OpenSCENARIO scenarios" to "OpenSCENARIO scenarios" since it displays more a conceptual overview instead of doing something in an active manner -
to move the content of the "Notes for this version of ASAM OpenSCENARIO" section to the introduction, since it defines constraints regarding the standard that should be mentioned at the beginning.
File: writing_a_scenario.adoc