diff --git a/docs/anchors/plain-english-strunk-white.adoc b/docs/anchors/plain-english-strunk-white.adoc new file mode 100644 index 0000000..ecf909d --- /dev/null +++ b/docs/anchors/plain-english-strunk-white.adoc @@ -0,0 +1,50 @@ += Plain English according to Strunk & White +:categories: communication-presentation +:roles: technical-writer, software-developer, consultant, educator, business-analyst +:related: gutes-deutsch-wolf-schneider, bluf, pyramid-principle +:proponents: William Strunk Jr., E.B. White +:tags: writing, english, clarity, style, prose, language, plain-english + +[%collapsible] +==== +Full Name:: Plain English according to Strunk & White ("The Elements of Style") + +Also known as:: Strunk & White, The Elements of Style, Plain Style Writing + +[discrete] +== *Core Concepts*: + +Omit Needless Words:: Every word in a sentence should serve a purpose; cut words that add bulk without adding meaning — "the fact that" → "that", "owing to the fact that" → "since" + +Use Active Voice:: Prefer active constructions over passive; active voice is more direct, vigorous, and concise — "The dog bit the man" not "The man was bitten by the dog" + +Use Definite, Specific, Concrete Language:: Prefer the particular and tangible over the vague and abstract; concrete details make writing vivid and persuasive + +Write With Nouns and Verbs:: Rely on strong nouns and verbs rather than adjectives and adverbs; the right noun or verb makes modifiers unnecessary + +Place the Emphatic Words at the End:: The most important idea in a sentence belongs at its end — the position of greatest emphasis + +Use Parallel Form:: Express coordinate ideas in similar grammatical form; parallelism aids comprehension and gives prose a pleasing rhythm + +Avoid Qualifiers:: Remove weakening qualifiers like "rather", "very", "little", "pretty" — they dilute the force of the statement + +Revise and Rewrite:: Good writing is rewriting; a first draft is a starting point, not a finished product + +Key Proponents:: William Strunk Jr. ("The Elements of Style", 1918); E.B. White (revised edition, 1959) + +[discrete] +== *When to Use*: + +* Writing technical documentation, reports, emails, and API documentation +* Reviewing or editing any English prose for clarity and conciseness +* Coaching writers to reduce verbose or bureaucratic language +* Preparing communications for broad, non-specialist audiences +* Any writing where clarity and brevity are paramount + +[discrete] +== *Related Anchors*: + +* <> — the German-language equivalent of clarity-first writing principles +* <> — complements plain style with a structure that leads with the conclusion +* <> — a complementary framework for structuring arguments hierarchically +==== diff --git a/docs/anchors/plain-english-strunk-white.de.adoc b/docs/anchors/plain-english-strunk-white.de.adoc new file mode 100644 index 0000000..ef8f0c1 --- /dev/null +++ b/docs/anchors/plain-english-strunk-white.de.adoc @@ -0,0 +1,50 @@ += Plain English nach Strunk & White +:categories: communication-presentation +:roles: technical-writer, software-developer, consultant, educator, business-analyst +:related: gutes-deutsch-wolf-schneider, bluf, pyramid-principle +:proponents: William Strunk Jr., E.B. White +:tags: writing, english, clarity, style, prose, language, plain-english + +[%collapsible] +==== +Vollständiger Name:: Plain English nach Strunk & White ("The Elements of Style") + +Auch bekannt als:: Strunk & White, The Elements of Style, Plain Style Writing + +[discrete] +== *Kernkonzepte*: + +Überflüssige Wörter weglassen:: Jedes Wort in einem Satz muss einen Zweck erfüllen; Wörter, die nur Volumen ohne Bedeutung erzeugen, werden gestrichen — "the fact that" → "that", "owing to the fact that" → "since" + +Aktiv statt Passiv:: Aktive Konstruktionen sind direkter, lebendiger und prägnanter als passivische — "Der Hund biss den Mann" nicht "Der Mann wurde vom Hund gebissen" + +Konkrete und spezifische Sprache:: Das Besondere und Greifbare dem Vagen und Abstrakten vorziehen; konkrete Details machen Texte lebendig und überzeugend + +Mit Substantiven und Verben schreiben:: Starke Substantive und Verben statt Adjektive und Adverbien verwenden; das richtige Substantiv oder Verb macht Attribute überflüssig + +Wichtige Wörter ans Satzende:: Die wichtigste Aussage eines Satzes gehört ans Ende — die Position mit der größten Wirkung + +Parallele Strukturen verwenden:: Koordinierte Ideen in ähnlicher grammatischer Form ausdrücken; Parallelismus erleichtert das Verständnis und gibt dem Text einen angenehmen Rhythmus + +Abschwächende Wörter vermeiden:: Abschwächer wie "ziemlich", "irgendwie", "ein bisschen" entfernen — sie verwässern die Kraft der Aussage + +Überarbeiten und umschreiben:: Gutes Schreiben ist Umschreiben; ein erster Entwurf ist ein Ausgangspunkt, kein fertiges Produkt + +Schlüsselvertreter:: William Strunk Jr. ("The Elements of Style", 1918); E.B. White (überarbeitete Ausgabe, 1959) + +[discrete] +== *Wann zu verwenden*: + +* Beim Verfassen technischer Dokumentationen, Berichte, E-Mails und API-Dokumentationen +* Beim Überprüfen oder Redigieren englischer Prosatexte auf Klarheit und Prägnanz +* Beim Coaching von Autoren zur Reduktion von wortreicher oder bürokratischer Sprache +* Bei der Vorbereitung von Kommunikation für ein breites, nicht-spezialisiertes Publikum +* Überall dort, wo Klarheit und Kürze an erster Stelle stehen + +[discrete] +== *Verwandte Anker*: + +* <> — das deutschsprachige Äquivalent zu klarheitsfokussierten Schreibprinzipien +* <> — ergänzt den klaren Schreibstil mit einer Struktur, die mit der Schlussfolgerung beginnt +* <> — ein ergänzendes Framework zur hierarchischen Strukturierung von Argumenten +==== diff --git a/skill/semantic-anchor-translator/references/catalog.md b/skill/semantic-anchor-translator/references/catalog.md index f2f2f00..3cdfd39 100644 --- a/skill/semantic-anchor-translator/references/catalog.md +++ b/skill/semantic-anchor-translator/references/catalog.md @@ -225,6 +225,10 @@ Source: https://github.com/LLM-Coding/Semantic-Anchors - **Proponents:** Wolf Schneider - **Core:** Short sentences, active voice, verbs over nouns (no Nominalstil), concrete language, no filler words — clarity-first principles for German writing +### Plain English according to Strunk & White +- **Proponents:** William Strunk Jr., E.B. White +- **Core:** Omit needless words, use active voice, prefer concrete language, write with nouns and verbs — clarity-first principles for English writing ("The Elements of Style") + ### Chatham House Rule - **Proponents:** Chatham House - **Core:** Info can be used but not attributed to speaker/org diff --git a/website/public/data/anchors.json b/website/public/data/anchors.json index dfb0949..4e0921f 100644 --- a/website/public/data/anchors.json +++ b/website/public/data/anchors.json @@ -1644,6 +1644,39 @@ ], "filePath": "docs/anchors/owasp-top-10.adoc" }, + { + "id": "plain-english-strunk-white", + "title": "Plain English according to Strunk & White", + "categories": [ + "communication-presentation" + ], + "roles": [ + "technical-writer", + "software-developer", + "consultant", + "educator", + "business-analyst" + ], + "related": [ + "gutes-deutsch-wolf-schneider", + "bluf", + "pyramid-principle" + ], + "proponents": [ + "William Strunk Jr.", + "E.B. White" + ], + "tags": [ + "writing", + "english", + "clarity", + "style", + "prose", + "language", + "plain-english" + ], + "filePath": "docs/anchors/plain-english-strunk-white.adoc" + }, { "id": "problem-space-nvc", "title": "Problem Space NVC", diff --git a/website/public/data/categories.json b/website/public/data/categories.json index a97fd01..b5ad520 100644 --- a/website/public/data/categories.json +++ b/website/public/data/categories.json @@ -8,6 +8,7 @@ "gutes-deutsch-wolf-schneider", "mece", "myers-briggs-type-indicator", + "plain-english-strunk-white", "pyramid-principle" ] }, diff --git a/website/public/data/metadata.json b/website/public/data/metadata.json index 8d136ef..fcfdf1b 100644 --- a/website/public/data/metadata.json +++ b/website/public/data/metadata.json @@ -1,15 +1,15 @@ { - "generatedAt": "2026-03-12T10:09:47.494Z", + "generatedAt": "2026-03-12T10:36:04.925Z", "version": "1.0.0", "counts": { - "anchors": 94, + "anchors": 95, "categories": 12, "roles": 12 }, "statistics": { - "averageRolesPerAnchor": "2.98", + "averageRolesPerAnchor": "3.00", "averageCategoriesPerAnchor": "1.00", - "anchorsWithTags": 50, - "anchorsWithRelated": 20 + "anchorsWithTags": 51, + "anchorsWithRelated": 21 } } \ No newline at end of file diff --git a/website/public/data/roles.json b/website/public/data/roles.json index efc0176..1e179d1 100644 --- a/website/public/data/roles.json +++ b/website/public/data/roles.json @@ -16,6 +16,7 @@ "jobs-to-be-done", "mece", "moscow", + "plain-english-strunk-white", "problem-space-nvc", "pyramid-principle", "regulated-environment", @@ -45,6 +46,7 @@ "moscow", "myers-briggs-type-indicator", "owasp-top-10", + "plain-english-strunk-white", "problem-space-nvc", "pyramid-principle", "regulated-environment", @@ -99,6 +101,7 @@ "gutes-deutsch-wolf-schneider", "mental-model-according-to-naur", "myers-briggs-type-indicator", + "plain-english-strunk-white", "socratic-method", "solid-principles", "test-double-meszaros", @@ -266,6 +269,7 @@ "morphological-box", "mutation-testing", "owasp-top-10", + "plain-english-strunk-white", "property-based-testing", "regulated-environment", "rubber-duck-debugging", @@ -336,6 +340,7 @@ "ears-requirements", "gutes-deutsch-wolf-schneider", "lasr", + "plain-english-strunk-white", "pyramid-principle", "todotxt-flavoured-markdown" ]