Schreiben falschparker Muster

Obwohl diese Begründung in Mustersprachen ausgedrückt wurde, gelten dieselben Argumente für die Verwendung eines laufenden Beispiels in eigenständigen Mustern. Stellen Sie sicher, dass das Muster für sich allein stehen kann, in der Lage, seine wesentlichen Konzepte zu kommunizieren, auch wenn die Codebeispiele gelöscht wurden. Codebeispiele sollten als optionaler Bonus behandelt werden, der Konzeptverstärkung und Implementierungsanleitung für Leser bietet, die mit der Sprache der Beispiele vertraut sind. Stellen Sie sicher, dass Codebeispiele, die in den Text eingebettet sind, leicht übersprungen werden können oder dass sie sich in einem separaten überspringbaren Abschnitt befinden. Häufig hervorgehobene Probleme sind selbst ein Beispiel für die Beschreibung separater Probleme, da sie in erster Linie vorhanden ist, um den Leser auf die alternativen Lösungen hinzuweisen. Dies wird leicht daran erkannt, dass der Lösungsabschnitt den Leser lediglich auf eine Reihe anderer Muster verweist; es wirkt wie ein “Verkehrspolizist”. Suchen Sie eine aussagekräftige Metapher für das Muster, und benennen Sie das Muster entsprechend. Einige Leute sind besser mit Metaphern als andere, also, wenn eine gute Metapher nicht auf Sie springt, gehen Sie zurück zu Noun Phrase Name. Im Idealfall wird eine Metapher für den durchschnittlichen Leser vertraut und leicht verständlich sein. Wenn man die Metapher erklären muss, ist sie nicht vertraut genug.

Identifizieren Sie eindeutig, wie sich Problem und Lösung auf die Metapher beziehen, so dass der Leser in der Lage ist, sein Verständnis der Metapherkonzepte mit Ihrem Muster zu verknüpfen. Wie können Sie es dem Leser erleichtern, eine Mustersprache in die Praxis umzusetzen? Diese Mustersprache verwendet eine “Bullet-Liste” innerhalb einer Forces-Überschrift, um die Kräfte sichtbar zu machen. Wie geben Sie dem Leser einen Überblick über eine Reihe von Mustern? Separate Problembeschreibung löst das Problem, indem die gemeinsame Lösung in ein separates Muster einfließt. Sie schreiben eine Softwarearchitektur oder ein Designmuster und schließen Codebeispiele ein. Diese Mustersprache ist keineswegs vollständig. Solange sich die Kunst des Musterschreibens weiterentwickelt und reift, muss sich diese Sprache mit ihr entwickeln. Es gibt viele Bereiche, die diese Sprache noch nicht einmal zu erfassen versucht hat. Es schreibt keinen Prozess für das Erstellen einer Muster- oder Mustersprache vor.

Eine Reihe solcher Muster fällt mir ein, Muster wie “Die Lösung aufzeichnen”, das Problem bestimmen, die Kräfte suchen und das Problem vom Kontext trennen. Jeder Abschnitt beginnt mit einer kurzen Zusammenfassung, die die im Abschnitt beschriebenen Muster vorstellt. Die Muster in der gesamten Sammlung werden in Abbildung 1 grafisch dargestellt und am Ende dieses Artikels im Abschnitt Problem/Lösungszusammenfassung in den Tabellen 1-4 zusammengefasst. Buffalo Mountain ist ein Beispiel für einen Metaphernamen, der nicht klar als Teil der Musterbeschreibung erklärt wird, daher hat es nur Bedeutung für den Autor und diejenigen, mit denen er mündlich geteilt wurde. Sie schreiben ein Muster und haben obligatorische Elemente vorhanden angewendet. Um das Verweisen auf Muster aus anderen Mustern zu vereinfachen, geben Sie Ihren Mustern evokative Musternamen an und fassen Sie deren Absichten in einem Absichtskatalog oder einer Problem-/Lösungszusammenfassung zusammen. Diese Mustersprache ist selbst ein Beispiel für die Lösung des komplexen Problems des Schreibens von Mustern und Mustersprachen. Es stellt die Lösung als eine Reihe von Mustern dar, von denen jedes die Lösung für ein bestimmtes kleineres Problem beschreibt. Wenn der Leser versucht, sich mit einer Reihe von Mustern vertraut zu machen, möchte er oft schnell “auf die Jagd” gehen. Zu viele Informationen kommen in den Weg. Ein Großteil der Informationen in einem Muster ist nur erforderlich, wenn Sie die Liste eingegrenzt haben oder sich für die Verwendung des Musters entschieden haben.