docs-as-code

docs-as-code - A game changer for automotive

Motivation

Software development in the automotive industry has been marred with heavy weight tooling or tooling with a lot of breaks or less automation possibilities. This leads to a lot of inefficiency in software development, resulting in delayed releases and thereby significant loss on competitiveness.

Technical Description

docs-as-code in simple terms means, using the same tools and workflows for creating engineering artifacts, as developers use for writing and maintaining code. This means,

Experience level:

Intermediate

Automotive & Mobility

Docs-as-code using AsciiDoc & Antora for open standardization

Christian Gödert (ASAM e. V.)

Benjamin Engel (ASAM e.V.)

For the past three years the standardization organization ASAM e.V. has been working on a docs-as-code approach for the continued development of its open standards. This approach is built from the ground up to support modern collaborative workflows with open source solutions like Gitlab, AsciiDoc and, lately, Antora at its core. This presentation will provide some insight into the motivation behind the transition from classical approaches used in standardisation, the workflow we have setup, the challenges we encountered along the way and where we want to continue evolving the toolchain.

Experience level:

Beginner

The Open Source Way