Use Meaningful Enum Values in 'Ausschreibungsstatus'

[hf-kklein]

Not hard-to-guess phase numbers

Originally posted by @hf-krechan in #218 (comment)

[snsttr]

Es gibt immer vier Phasen, diese können aber unterschiedliche Bezeichnungen haben. Deshalb haben wir die allgemeingültigen Bezeichnungen "PHASE1" bis "PHASE4" gewählt.

[hf-kklein]

Ich bin fachlich sicher kein Experte. Aber aus technischer Sicht ist ein Enum, bei dem jeder unter "Phase 1" was allgemeingültig anderes versteht, für ein gemeinsames Datenmodell nicht hilfreich, weil das Enum eine Stabilität suggeriert, die das Datenmodell so nicht bietet bzw. wegen der von dir genannten unterschiedlichen fachlichen Bezeichnungen (oder dem unterschiedlichen Verständnis?) nicht bieten kann.

Wenn wir den einzelnen Phasen je einen Namen oder wenigstens Beispiele (z.B. "Phase 1 ist üblicherweise die Ausschreibungsphase" oder "Phase 4 ist der erfolgreiche Vertragsabschluss") in der Dokumentation hinterlegen könnten wäre das sehr hilfreich für weitere Nutzer des Datenmodells.

Sonst könnten wir auch einen String oder Integer nehmen.

Könntest du bitte bier (beispielhafte, nicht allgemeingültige) Beschreibungen für die vier Phasen bereitstellen, damit sich die Leser der Doku ein Bild machen können, was gemeint ist?

[snsttr]

Reicht die Beschreibung, die die BO4E-Seite hinterlegt ist, aus?
https://www.bo4e.de/dokumentation/enumerations/enum-ausschreibungsstatus

Man könnte die Einträge dann in der Doku hier noch etwas umformulieren, z.B. zu "PHASE1: hierbei handelt es sich üblicherweise um den Teilnahmewettbewerb"

[hf-kklein]

ja, damit kann ich was anfangen :) danke.
@leon bitte einen pr aufmachen mit den doku-ergänzungen