Chapter 7.5 asset schema: different markdown heading sizes and no capital letter?

[AsamDiegoSanchez]

Is your feature request related to a problem? Please describe.

In the chapter 7.5 asset schema the content is automatically generated, but the sub-sections are written in lowercase, according to the Editorial guide should start with capital letter (https://internal.pages.asam.net/asam-editorial-guide/editorial-guide-generator/editorialguide-asciidoc/1.0.0/Editorial_guide/05_headings.html)

Also I can appreciate different sub-titles sizes:

see: frontAxle and maxsteering

Describe the solution you'd like

Correct the capital letter on each subsection.

Check the sub-title letter sizes to be consistent

Check other generated content in the document which might have the same problems.

[AsamDiegoSanchez]

@ClemensLinnhoff is this something that could be solved modifying the schemas?

[ClemensLinnhoff]

I think we have to deviate from the editorial guide here since the schema chapters accurately represent the actual schema files. According to the JSON convention, all fields in the schemas are written in lowerCamelCase. So I would prefer if we could keep the same naming in the documentation.

The subtitle sizes are automatically set by the antora (or asciidoctor) template. In the files it is just plain ASCIIdoc with no additional formatting.

[AsamDiegoSanchez]

Ok, I understand, let me discuss it internally

[AsamDiegoSanchez]

Feedback: If the text is actually representing code elements or attributes, then deviation from the editorial guide is accepted. These are subject to the formatting rules for said elements.
Issues can be closed