Kapitel 20. Schreiben für Vielbeschäftigte
Diese Arbeit wurde mithilfe von KI übersetzt. Wir freuen uns über dein Feedback und deine Kommentare: translation-feedback@oreilly.com
Erwarte nicht, dass jeder Wort für Wort liest
Die meisten Organisationen sind voll von langweiligen Dokumenten, die weitgehend ungelesen bleiben. Das heißt aber nicht, dass Dokumentation eine schlechte Idee ist. Wenn sie gut gemacht ist, ist sie immer noch das beste Mittel, um alle Beteiligten sprichwörtlich auf die gleiche Seite zu bringen. Mit der Zeit sind kurze, aber präzise technische Positions- und Entscheidungspapiere zu einem Markenzeichen meiner Architekturteams geworden.
Der Titel dieses Kapitels ist ein Wortspiel mit den Titeln beliebter Bücher wie Japanisch für Vielbeschäftigte und impliziert absichtlich die Doppeldeutigkeit, dass wir nicht nur für ein vielbeschäftigtes Publikum schreiben, sondern auch vielbeschäftigte Autoren sind.
Skalen schreiben
Leider ist das Schreiben von viel anstrengender als das Lesen, aber beim Schreiben zu sparen ist klug und dumm, denn das geschriebene Wort hat enorme Vorteile gegenüber dem gesprochenen Wort oder Folienpräsentationen:
- Es skaliert
-
Du kannst ein großes Publikum ansprechen, ohne alle in einem Raum zu versammeln (Podcasts können das zugegebenermaßen auch leisten).
- Es ist schnell
-
Menschen ...
Get Der Software-Architekt-Aufzug 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.