Journal
Dokumentierte Fakten statt Behauptungen: Was sich geändert hat, welchen tatsächlichen Nutzen wir daraus gezogen haben und wie die eigene Positionierung des Projekts aufgrund von Beweisen neu formuliert wurde.
Alles in diesem Abschnitt ist mit einem Datum versehen, und jedes Datum kann mit der Historie des Repositories abgeglichen werden. Das ist der Sinn dieses Abschnitts: Eine Behauptung, die man nicht widerlegen kann, ist es nicht wert, veröffentlicht zu werden.
Dies sind interne Arbeitsdokumente, die so wiedergegeben werden, wie sie geschrieben wurden – einschließlich des spezifischen Vokabulars, der Phasen- und Dateinamen des Projekts, ohne dass sie hier für eine bessere Lesbarkeit umformuliert wurden. Ein Protokoll, das nachträglich überarbeitet wurde, verliert seinen Beweiswert.
Wofür jedes Datensatz ist
Das Entwicklungsprotokoll dokumentiert Entscheidungen, nicht Commits – warum etwas auf diese Weise geändert wurde und welche Kosten die Alternative hatte. Es wird während der Arbeit verfasst, was es gelegentlich etwas umständlich macht: Auch die Rückschläge sind darin enthalten, einschließlich des Abends, an dem die eigene Positionierungsaussage des Projekts auf der Grundlage von Fakten und nicht von Intuition neu formuliert wurde.
Wie Modelle funktionieren dokumentiert, was Sprachmodelle tatsächlich mit diesem Werkzeug machen, einschließlich der Fehler, die sie dabei machen.
Barrierefreiheit im Web dokumentiert, welche öffentlichen Quellen tatsächlich auf die Anfrage eines Systems antworten – gezählt, nicht angenommen. Die Erkenntnis →
Warum die Fehler hier sind
Ein Projekt, das nur seine Erfolge veröffentlicht, sagt Ihnen nichts darüber, an welchem Tag es nicht mehr für Sie funktionieren wird. Dieses Log dokumentiert eine echte Entdeckungsabweichung, die die eigene Aussage des Projekts über sich selbst veränderte, einen realen Sicherheitsverstoß, der am selben Tag gefunden und behoben wurde, sowie die Messungen, die diese Ereignisse aufgedeckt haben.