Mehr Urlaub = bessere Dokumentation

Kennen Sie die Situation? Sie fahren am nächsten Tag in den Urlaub und wollen noch die wichtigsten Dinge an Ihre Kollegen übergeben. Sie schreiben ein paar E-Mails an unterschiedliche Leute und erklären, wo bei Rückfragen welche Dokumente zu finden sind, warum sich der Preis für Produkt X nochmal geändert hat und welche Schritte Sie im Vorgang Y schon erledigt haben und welche noch zu tun sind.

Der letzte Tag vor dem Urlaub ist für Dokumentation eine ideale Situation:

Sie schreiben kurze Dokumente. (Wer liest gern lange Dokumente?)
Sie schreiben an spezifische Empfänger. (Wer liest gern Dinge, die für ihn irrelevant sind?)
Sie fangen mit dem Überblick an und verweisen auf die Details. (Wer liest gern weiter, wenn er den Zusammenhang nicht versteht?)
Sie beginnen mit den wichtigsten Dingen. (Wer liest gern unwichtige Dinge?)

Dokumentation bedeutet für mich nicht, ausführlich über alle Details zu berichten. Dokumentation enthält für mich genau die Informationen, die ich selbst oder mein Team braucht, um sich schnell genug in einen Vorgang einzuarbeiten.

Aufschreiben ist gut für die Teamarbeit. Andreas Rüping bringt es im Vorwort seines Buchs über agile Dokumentation (/1/) auf den Punkt:

"Documents can preserve knowledge within a team, and prevent the team from re-inventing things when team members leave and new people join."

Fangen Sie an, Dinge für Ihr Team und für Sie selbst aufzuschreiben. Schreiben Sie so, als hätten Sie ab morgen Urlaub. Wenn Sie die Situation oben kennen, wissen Sie ja bereits, dass Sie gut dokumentieren können.

Anmerkungen

/1/ Rüping, Andreas: Agile Documentation : A Pattern Guide to Producing Lightweight Documents for Software Projects. : John Wiley & Sons, 2005, http://www.amazon.de/Agile-Documentation-Producing-Lightweight-Documents/dp/0470856173/

Kommentare

Beliebte Posts aus diesem Blog

Microsoft Teams: Die neuen Besprechungsnotizen - Loop-Komponenten

Haben Sie in letzter Zeit in einer Teams-Besprechung die Notizen geöffnet? Dort sind inzwischen die Loop-Komponenten hinterlegt. Die sind zwar etwas nützlicher als das, was zuvor zur Verfügung stand. Trotzdem ist noch Luft nach oben. Und es gibt sogar einige ernstzunehmende Stolperfallen. Hier ein erster, kritischer Blick auf das was Sie damit tun können. Und auch darauf, was Sie besser sein lassen.

Agile Sternbilder: Die Entdeckung kosmischer Agilitäts-Superkräfte

Hast du dich je gefragt, ob dein Sternzeichen deine Fähigkeiten in einer agilen Arbeitsumgebung beeinflusst? In diesem Blogpost tauchen wir ein in die faszinierende Welt der Astrologie und ihre mögliche Verbindung zu modernen Arbeitsweisen. Entdecke, wie die Sterne deine agilen Stärken prägen könnten. Ob überzeugter Agilist oder neugieriger Sternzeichenliebhaber – dieser Artikel kann dir neue Perspektiven eröffnen und vielleicht sogar dein nächstes Teamprojekt inspirieren!

Building Bridges

How many times have I rolled my eyes at the assertion, “But, you can’t build a bridge with Scrum”? The claim annoys as much for its misunderstanding of Scrum as for its naïve view of projects. Curiously enough, I recently discovered support for Scrum in a recent book about big projects. Maybe you can build a bridge with Scrum after all.

Den passenden Job finden

Hier teile ich, wie ich daran arbeite, endlich den richtigen Job zu finden. Kleingedrucktes: Dieser Artikel richtet sich (natürlich) an jene, die gerade in der luxuriösen Position sind, dass sie nicht jedes Angebot annehmen müssen. Anstatt von Engagement zu Engagement zu hetzen und frustriert zu sein über Konzernstrukturen, fehlende Ausrichtung und die Erkenntnis, dass in einem selbst beständig die Hintergrundfrage nagt, ob es das ist, womit man seine immer knapper werdende Lebenszeit wirklich verbringen möchte, gibt es manchmal auch die Möglichkeit, die nächste berufliche Station etwas nachhaltiger auszusuchen - auch, um tatsächlich (etwas) mehr beitragen zu können.

Prozessorientierte Dokumentation - Wie geht das?

Bestimmte Softwareprodukte brauchen eine Dokumentation, damit neue Anwender:innen schnell lernen, wie sie mit der Software arbeiten können. Aber wie entsteht diese Dokumentation? Wie lange dauert das?

Die Microsoft Teams-Not-To-Do-Liste

Viele hoffen, dass es für die Einrichtung von Microsoft Teams den Königsweg gibt, den perfekten Plan – doch den gibt es leider (oder glücklicherweise?) nicht. Genauso wenig, wie es jemals einen Masterplan für die Organisation von Gruppenlaufwerken gab, gibt oder je geben wird. Was gut und vernünftig ist hängt von vielen Faktoren und ganz besonders den Unternehmensprozessen ab. Sicher ist nur eines: Von alleine entsteht keine vernünftige Struktur und schon gar keine Ordnung. Dafür braucht es klare Entscheidungen.

Agilität ist tot. Ausgerechnet jetzt?

Agilität wird zurückgefahren, Hierarchien kehren zurück. Doch ist das wirklich der richtige Weg in einer Welt, die immer unberechenbarer wird? Oder erleben wir gerade eine riskante Rolle rückwärts?

Wie beschreibt man einen Workshop für eine Konferenz?

Konferenzen bieten immer ein gutes Forum, um sein Wissen und seine Erfahrungen zu teilen. Was für die Vortragenden selbstverständlich scheint, ist für die Besucher:innen oft unverständlich. Wie können Vortragende ihren Workshop in 2-3 Sätzen beschreiben, damit die Besucher:innen schnell einschätzen können, er sich für sie lohnt?

Gemeinsam eine Anwenderdokumentation erstellen

Unternehmenssoftware ist ein wichtiges Bindeglied zwischen Anwenderinnen und Anwendern, den Unternehmensprozessen und den Ergebnissen. Normalerweise schreibt der Hersteller der Software die Dokumentation für diejenigen, die die Software benutzen. Wenn die Software allerdings stark angepasst wurde, muss die Dokumentation von denen kommen, die die Prozessmaschine am besten verstehen - den Anwenderinnen und Anwendern. Wie könnte man das praktisch machen?

Scrum und Hardware: Es kommt auf die Basics an

Man kann Hardwareprodukte agil entwickeln. Zum einen kommt Scrum aus der Hardwareentwicklung. Die Softwerker haben die Hardwarekonzepte auf ihre Situation übertragen. Zum anderen hat Hardwareentwicklung heute ganz viel mit Software zu tun. Gerade in frühen Phasen kann man sich mit Simulationen noch viele Wege offen halten und mehrere Pfade parallel verfolgen. In diesem Beitrag empfehle ich eine Podcastfolge und ein Buch, für alle, die mit der Geschwindigkeit ihrer Hardwareentwicklung nicht zufrieden sind.

Das Teamwork-Blog

Dieses Blog durchsuchen