Skip to content

[HandoverDocumentation IDTA-02004 2.0.1] Table 1: the English ClassNames for 02-03 and 03-01 do not match the German in the same row #319

Description

@dev365code

Hello. A question about Table 1 of IDTA 02004 (Handover Documentation), from
someone building tooling that has to decide which class names to accept.

The table gives each VDI 2770 document class an English and a German name. For
two rows the two do not describe the same thing:

ClassId German in Table 1 English in Table 1
02-03 Bauteile Assemblies Bauteile are components or parts; assemblies would be Baugruppen
03-01 Montage, Demontage Commissioning, decommissioning Montage/Demontage is assembly and disassembly; commissioning and decommissioning would be Inbetriebnahme/Außerbetriebnahme

That can be checked inside Table 1 itself, without reference to anything else.

It matters because the other freely available rendering of the same table — the
VDI 2770 reference implementation, DigitalDataChainConsortium/vdi2770, whose
Constants.java describes its English names as "defined in VDI 2770 guideline"
— reads those two rows as Components and Assembly, disassembly, matching the
German.

This is not a claim that Table 1 is wrong and the reference implementation is
right.
On two other rows the reference implementation is the one that departs
from the German, and Table 1 is closer:

ClassId German (both agree) Table 1 reference implementation
02-03 Bauteile Assemblies Components
02-04 Zeugnisse, Zertifikate, Bescheinigungen Certificates, declarations Certificates
03-01 Montage, Demontage Commissioning, decommissioning Assembly, disassembly
03-04 Inspektion, Wartung, Prüfung Inspection, maintenance, testing Inspection, maintenance
04-01 Vertragsunterlagen Contract documents contract documents

The twelve German names are identical in both sources. Five of the English ones
differ, and each source is the closer reading on two of them — which is what
made me think the difference is translation rather than error on either side.

Table 1's English has also been stable across IDTA 02004 v1.2 (2023-03),
v2.0.1 (2025-11) and IDTA 02035-2 (2026-02), so this is a question about the
table rather than a typo in one edition.

The question: are Table 1's English names quoting the English edition of
VDI 2770 Blatt 1:2020, or are they an independent translation for this submodel?

It changes what an implementer should do. VDI 2770 tooling that validates
ClassName against its own list rejects a document carrying Table 1's English
for 02-03, 02-04, 03-01 and 03-04 — four of twelve — so someone populating a
Handover Documentation submodel from an existing VDI 2770 container, or the
reverse, has to pick one spelling and be wrong on one side.

A smaller, related question: would recording the ClassId and the German name
as the identifying pair be worth considering? Those are the parts both published
sources agree on, and they are what an implementation can match on safely today.

I can supply the full twelve-row comparison as a data file if that is useful.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions