Tag: Wiki

Softwarearchitekturen dokumentieren und kommunizieren

Mein Fazit: Ziel des Buches ist es, den Leser viele wichtige Informationen und praktischen Beispiele in die Hand zu geben, um die Architektur jedes Software-Produktes angemessen zu beschreiben. arc42 zieht sich als roter Faden durch das Buch. Eine gute Wahl, wie ich finde. Ich musste aber schnell feststellen, dass der Autor wenig auf agile Methoden…
Read more

Qualität sichtbar machen

In einem Vortrag über Herausforderungen und Ergebnisqualität der Pflege im Gesundheitswesen des 21. Jahrhundert war das Motto «Gutes tun und es gut tun». Die Autorin hat gleich zu Beginn ein paar sehr gute Fragen gestellt, die ich für die Methode CARDS+ und für die Frage der Autoren nach der Qualität einer Produktdokumentation adaptieren konnte: Wie…
Read more

Qualität durch Beschränkung

Agile Entwicklung mit Scrum hat aus gutem Grund Regeln, die alle einzuhalten sind. Scrum ist es nur, wenn die drei Rollen Product-Owner, Scrum-Master und Team besetzt sind, das Team in regelmäßigen Sprints ein Product-Backlog abarbeitet und kontinuierlich Produktinkremente liefert. Jeder Sprint wird gemeinsam geplant (Refinement, Planning). Am Ende jedes Sprints gibt es eine Präsentation der…
Read more

Qualität ist Kopfsache

Ein ganz wesentliches Ziel der Methode CARDS+ ist die Qualität der Inhalte. Prinzipien und Praktiken der Methode sollen unter anderem Autoren die Pflege einer Produktdokumentation im Wiki so einfach wie möglich machen. Die wohl wichtigsten Leitsätze sind: Erfasse jede Information nur an einer Stelle im Wiki. Erfasse nur jene Information, für die es Leser gibt. Erfasse keine…
Read more

Qualität braucht Kompetenz und Verantwortung

“Code smells”, sagte Kent Beck. Bei übel riechendem Code handelt es sich allgemein um Code, der einer gemeinsamen Vorstellungen von guter und lesbarer Programmierung nicht entspricht. Gleiches gilt auch für Texte einer Produktdokumentation im Wiki. Sie brauchen eine Struktur. Kein Scrum-Team braucht literarisch wertvolle Werke. Texte werden von ihnen genutzt, um ein technisches System zu…
Read more

Wissenswerte

Moderierte Kommentare im Wiki sind eine hilfreiche Metrik für die Qualität der Produktdokumentation.