Cortex Docs: Zwei Ausgaben aus einer Spezifikation dürfen die Einheit nicht verlieren

Zwei Papierausgaben einer fiktiven Spezifikation zeigen, wie Wert, Einheit und Leerfeld beim Leser ankommen.

Quelle: www.producthunt.com
October 6, 2026
2 min

Dokumentation und Entwicklerreferenz aus einer Spezifikation sparen Doppelpflege. Ähnliche Ausgaben vermitteln aber nicht unbedingt dieselbe Vorgabe. Im September 2026 stellte Cortex Docs die Generierung durchsuchbarer Dokumentation und typisierter SDKs aus Spezifikationen vor. Hier wird nur die sichtbare Bedeutung geprüft, ohne Spezifikationscode, SDK-Nutzung oder echte Generierung.

Beide Ausgaben mit einer Spezifikationskarte prüfen

Die Breite wird in Rastereinheiten angegeben, „0“ bedeutet keine Breite, und leer bedeutet unbestätigt statt null. Dokument A nennt alle drei. Referenz B schreibt „Breite: Zahl, Standard 0“ ohne Einheit. Geben Sie zwei Lesern jeweils einen Entwurf und denselben leeren Eintrag. Fragen Sie nach der Bedeutung von leer und der Einheit von „2“.

A sollte „unbestätigt, keine 0“ und „2 Rastereinheiten“ ergeben. B lässt die Einheit weg und ändert die Bedeutung des Leerfelds. „Standard 0“ zu streichen, ohne die Einheit zu ergänzen, behebt nur die Hälfte. Prüfen Sie Einheit, ausdrückliche Null und Leerfeld getrennt anhand der Vorlage. Die Bezeichnung „Breite“ reicht nicht. Die Muster sind erfunden; keine Schnittstellen, Projektverbindungen oder echten Dateien.

Erst die Vorgaben klären, dann Ausgaben hinzufügen

Wenn das Team laufend Dokumentation und Entwicklerreferenz pflegt, ist der gemeinsame Ausgangspunkt von Cortex Docs einen Vergleich wert. Für eine interne Seite reicht die ursprüngliche Tabelle. Definieren Sie fehlende Einheiten und Leerwerte zuerst. Ausgaben machen aus fehlenden Angaben keine Fakten. Es wurden weder Generierung, Verhalten, Kompatibilität noch Genauigkeit geprüft.

Hinweis zum Inhalt:Dieser Artikel basiert auf öffentlich verfügbaren Informationen und dient als Orientierung bei der Auswahl von Tools. Funktionen, Preise und zugehörige Richtlinien können sich jederzeit ändern; maßgeblich sind die aktuellen offiziellen Angaben.

Originalquelle:www.producthunt.com