.. SPDX-FileCopyrightText: 2026 Copyright (c) Contributors to the Eclipse Foundation
..
.. See the NOTICE file(s) distributed with this work for additional
.. information regarding copyright ownership.
..
.. This program and the accompanying materials are made available under the
.. terms of the Apache License Version 2.0 which is available at
.. https://www.apache.org/licenses/LICENSE-2.0
..
.. SPDX-License-Identifier: Apache-2.0

Conventions
===========

Sections
--------

Section headers (ref) are created by underlining (and optionally overlining) the section title with a punctuation character, at least as long as the text:

* ``#`` with overline, for components (e.g. classic diagnostic adapter, odx-converter)
* ``*`` with overline, for parts (about, requirements, architecture, design, implementation, tests)
* ``=`` for chapters within parts
* ``-`` for sections within chapters
* ``^`` for subsections
* ``"`` for subsubsections
* ``~`` for subsubsubsections