DRY in der Dokumentation
Warnung
Eine veraltete Dokumentation ist schlimmer als gar keine, denn sie führt aktiv in die Irre.
Die Dokumentation ist ein klassisches Schlachtfeld zwischen Management und Entwicklern: Die Manager brauchen mehr davon, und die Entwickler wollen weniger schreiben. Sie ist zugleich ein Schlachtfeld im Krieg gegen nicht kanonische Darstellungsweisen. Eigentlich sollten Entwickler imstande sein, aggressiv an die Veränderung ihres Codes heranzugehen, um seine Struktur zu verbessern und seine Weiterentwicklung zu ermöglichen. Wenn Sie für alle Ihre Programme Dokumentationen brauchen, müssen diese sich gleichzeitig weiterentwickeln. Allzu oft geraten aber Code und Dokumentation aus dem Takt; verantwortlich dafür sind Termindruck, ...
Get Produktiv programmieren now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
