Technische Dokumentation scheitert auf eine bestimmte und vorhersehbare Weise. Jemand schreibt in zwei ruhigen Wochen sehr viel davon, das System ändert sich, niemand pflegt sie nach, und binnen eines Jahres steht dort mit voller Überzeugung etwas Falsches. Ab diesem Punkt ist sie schlechter als gar nichts, denn wer...
Beiträge
Alle Beiträge an einem Ort. Finde Tutorials, Deep Dives, Anleitungen und Updates zu KI, Programmierung, Sicherheit, Infrastruktur und Webentwicklung.
Das Onboarding von Entwicklern wird meist daran gemessen, wie lange die Einführung dauert, und das ist das falsche Ende des Problems. Die Zahl, auf die es ankommt, ist eine andere: wie lange es dauert, bis eine neue Entwicklerin etwas ändern kann und dabei sicher ist, nichts anderes kaputtgemacht zu haben. In den...
Ein Uptime-SLA sieht aus wie ein Versprechen und verhält sich wie eine Rückerstattungsregel. Anbieter wissen das. Kunden häufig nicht, und sie unterschreiben ein Service Level Agreement in dem Glauben, Verfügbarkeit gekauft zu haben, während sie in Wirklichkeit einen kleinen Rabatt für den Fall gekauft haben, dass sie...
Die Softwarehinterlegung, im Markt meist Software-Escrow genannt, beantwortet eine berechtigte Sorge: Der Anbieter, der Ihr geschäftskritisches System gebaut hat und betreibt, verschwindet vom Markt, und Sie sitzen auf etwas, von dem Sie abhängen und das Sie nicht warten können. Ein Hinterlegungsvertrag legt den...
Die Wahl zwischen einem Festpreisvertrag und der Abrechnung nach Aufwand wird üblicherweise als Entscheidung über Risiko dargestellt, was richtig ist, und danach sofort falsch behandelt, weil beide Seiten annehmen, das Risiko verschwinde, statt sich lediglich zu verlagern. Es verschwindet nicht. Beim Festpreis trägt...
Disaster Recovery ist in einem kleinen Team meistens eine einzige Zeile in einem Dokument, das nie jemand geöffnet hat: Backups sind aktiviert. Diese Aussage stimmt, und sie ist trotzdem keine Antwort, denn sie sagt nichts darüber, wie alt die Daten im Ernstfall wären, wie lange das Zurückspielen dauert oder ob...
Content Pruning ist das Unintuitivste in der Suchmaschinenoptimierung, denn jeder Instinkt sagt, mehr Seiten müssten mehr Traffic bedeuten. Veröffentlichen fühlt sich nach Aufbau an. Löschen fühlt sich an, als würfe man Arbeit weg, die jemand bezahlt hat. Der Mechanismus, der das Entfernen nützlich macht, ist die...
Diskussionen über API-Versionierung beginnen meist am falschen Ende, nämlich bei der Frage, wo die Versionsnummer steht. Das ist die folgenloseste Entscheidung des ganzen Themas. Entscheidend ist, welche Änderungen überhaupt eine neue Version verlangen, und die meisten Teams irren sich dabei in Richtung Sorglosigkeit:...
Eine Software-Ausschreibung soll Anbieter vergleichbar machen. Die meisten erreichen das Gegenteil, weil sie eine Lösung so detailliert vorschreiben, dass die Antwort eingeengt wird, und zugleich genau die Angaben weglassen, die man zur Kalkulation bräuchte. Das Ergebnis sind fünf Angebote, die eine ganze Größenordnung...
Softwarewartungskosten sind die Zahl, die aus einem erfolgreichen Projekt achtzehn Monate später ein schwieriges Gespräch macht. Die Entwicklung war budgetiert, freigegeben und geliefert. Was nach dem Livegang passiert, wurde als „Support" bezeichnet und mit einem Betrag versehen, den jemand geschätzt hat, und dieser...