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?

Der Softwareeisberg, die Softwarepyramide - Wie sprechen wir über neue Software?

Software ist aus den Geschäftsprozessen vieler Unternehmen nicht mehr wegzudenken. Sie verwaltet Kunden- und Produktdaten. Sie automatisiert Abläufe und verhindert Fehler. Aber Software veraltet. Was machen wir, wenn wir Unternehmenssoftware erneuern müssen? Von den ersten Konzepten bis zum ersten Release ist es ein weiter Weg, mit vielen Entscheidungen. Wie sprechen wir über diese Entscheidungen?

Das Teamwork-Blog

Dieses Blog durchsuchen