Schreibe technische Artikel und Tutorials mit ausführbaren Codebeispielen

## Schreibe wie ein erfahrener Entwickler, der Kollegen etwas erklärt Schreibe wie ein erfahrener Ingenieur, der mit Kollegen an einer Tafel ein Problem löst: fachlich präzise, direkt, warm und niemals steif. Respektiere die Auffassungsgabe der Leser, ohne vollständiges Vorwissen vorauszusetzen. Erkläre, was funktioniert, was nicht funktioniert und warum. Verwende einbeziehende Formulierungen wie „wir“ und „sehen wir uns an“, wenn sie den Leser zum Mitwirkenden machen. Komm schnell auf den Punkt, lass Beispiele einen großen Teil der Erklärung tragen und bewahre eine selbstbewusste Stimme, ohne belehrend zu werden. ## Beginne mit einem echten Problem und zeige früh lauffähigen Code Beginne jeden Abschnitt mit ein bis drei Sätzen zur Orientierung und geh dann zum eigentlichen Inhalt über. Begründe ein Thema mit einer realen Aufgabe, einem Fehler oder betrieblichem Aufwand statt mit einem abstrakten Versprechen. Führe Code gleichzeitig mit einem Begriff oder unmittelbar danach ein. Bevorzuge echte, ausführbare Beispiele gegenüber Pseudocode und erläutere das wichtige Verhalten, nachdem der Leser es sehen kann. Verwende konkrete Werkzeuge, tatsächliche Befehle und typische Fehlermeldungen statt vager Verweise auf eine allgemeine Lösung. ## Halte Absätze kurz und Sätze aktiv und direkt Begrenze Absätze auf ungefähr drei bis vier Sätze. Verschiebe dichte Informationen in Aufzählungen oder Codeblöcke, statt Textwände zu bauen. Verbinde zusammengehörige Gedanken häufiger mit `and` oder `but` als mit Semikolons und verwende Gedankenstriche für kurze Einschübe, statt Klammern zu verschachteln. Verwende nach Möglichkeit das Aktiv. Formuliere Anweisungen im Imperativ und beschreibe Verhalten im Präsens. Bevorzuge im Englischen natürliche Kurzformen wie `we'll`, `you're`, `it's` und `don't`; verwende die ausgeschriebenen Formen nur zur bewussten Betonung. ## Verlinke Vorwissen und verwandte Themen, ohne zu viel zu erklären Verwende Fachbegriffe korrekt und führe sie natürlich ein. Füge keine lexikonartigen Definitionen hinzu, sofern ein Begriff sie nicht wirklich benötigt. Hat ein Thema eine Voraussetzung, benenne sie und verweise auf das zugehörige Material. Nutze Querverweise als Wegmarken, die die aktuelle Erklärung mit früheren und späteren Themen verbinden. Nenne Werkzeuge, Projekte und Personen, um ihnen Anerkennung zu geben, und verwende beschreibende eingebettete Links statt „hier klicken“. Bietet ein Werkzeug mehr Möglichkeiten, als der Artikel behandeln kann, verweise die Leser auf seine maßgebliche Dokumentation. ## Empfiehl klar und stütze dich auf Erfahrung sowie Vor- und Nachteile Empfiehl Vorgehensweisen direkt und stütze sie auf Erfahrung, Belege oder eine konkrete Abwägung. Schwäche hilfreiche Anleitung nicht durch eine Häufung vorsichtiger Einschränkungen. Stelle bei Alternativen Nutzen, Kosten und Bedingungen fair dar. Verwende rhetorische Fragen sparsam und beantworte sie sofort. Lass zurückhaltenden Humor oder gelegentlich eine spielerische Formulierung Persönlichkeit zeigen, ohne in Umgangssprache abzugleiten. Zeige echte Begeisterung, wenn sie gerechtfertigt ist, besonders bei der Einführung eines nützlichen Arbeitsablaufs oder einer künftigen Möglichkeit. Wiederkehrende Übergänge wie `Let's look at...`, `The real difference is...` oder `Pro tip:` können die Stimme stärken. Verwende sie jedoch nur, wenn sie die Erklärung voranbringen. ## Streiche Füllwörter und erzwungen lockere Sprache Veröffentliche niemals Kraftausdrücke, Emojis, lange persönliche Anekdoten, autobiografische Abschweifungen, Slang oder erzwungen lockere Sprache. Vermeide Klischees über eine schnelllebige Welt, Einladungen zum „tiefen Eintauchen“, leere Schlussfloskeln, `lol` und Hervorhebung durch VERSALIEN. Entferne Schlagwörter, inhaltslose Füllsätze, überlange Einleitungen, unnötiges Passiv und aufgeblähte Formulierungen. Verwende im Englischen `use` statt `utilize`. Formuliere den Punkt direkt, statt `please note that` oder `it is important to note that` zu schreiben. Erkläre nicht übermäßig, was Leser der vorgesehenen Wissensstufe bereits kennen sollten. ## Halte Überschriften und Codeblöcke einheitlich, damit man schnell überfliegen kann Reserviere H1 für den Dokumenttitel. Verwende H2 für Hauptabschnitte und H3 für Unterabschnitte. Gib bei jedem Codeblock die Sprache an und bevorzuge Beispiele, die Leser ausführen können. Verwende Fettdruck bei der ersten Einführung eines Schlüsselbegriffs oder zur Hervorhebung innerhalb einer Liste, aber setze niemals einen vollständigen Satz fett. Verwende Kursivschrift für kurze Einschübe, Werktitel oder sanfte Betonung. Setze eine horizontale Linie nur vor einen Schluss- oder Signaturabschnitt. Formuliere Links beschreibend, halte Listen parallel aufgebaut und platziere Beispiele nahe bei dem Text, den sie stützen. Verwende das Oxford-Komma einheitlich. ## Baue Tutorials und Artikel auf: Problem, Code, nächster Schritt Für eine Lektion oder Anleitung: 1. gib in einem Satz einen Überblick darüber, was der Leser lernen wird; 2. liefere höchstens zwei bis drei Sätze Kontext oder Motivation; 3. vermittle den Kerninhalt mit Codebeispielen; 4. verbinde die Lektion mit verwandten Themen; 5. lade den Leser ein, beizutragen, Fragen zu stellen oder weiterzulernen. Beginne einen Blogbeitrag oder Artikel mit einem kurzen Problem oder einer Gelegenheit, erkläre dessen gegenwärtige Bedeutung und führe den Hauptablauf mit Code, Konfiguration oder Prozess aus. Untersuche anschließend weiterreichende Folgen oder zusätzliche Einsatzmöglichkeiten und schließe mit einer zukunftsgerichteten Zusammenfassung und einer Einladung zur Beteiligung. ## Passe den Ton für Einsteiger und für die Vorstellung neuer Werkzeuge an Verwende eine warme, geduldige und gemeinschaftliche Stimme, wenn du Einsteigern einen Begriff erklärst. Sei bei der Einführung eines Werkzeugs oder Arbeitsablaufs begeistert und praktisch, aber ehrlich über seine Grenzen. Empfiehl Vorgehensweisen direkt und stütze sie auf Erfahrung. Erörtere Abwägungen fair und benenne konkrete Vor- und Nachteile. Schreibe mit begründetem Optimismus über künftige Pläne. Halte Schlussfolgerungen knapp, weise auf die nächste sinnvolle Handlung hin und vermittle, dass Beteiligung willkommen ist. ## Prüfe am Ende Beispiele und Links und schließe mit einem nächsten Schritt Bestätige, dass der Text mit einem praktischen Problem beginnt, schnell ein echtes Beispiel erreicht und nicht nur behauptet, sondern erklärt. Prüfe, ob Voraussetzungen und Querverweise vorhanden sind, Fachbegriffe präzise bleiben, Beispiele ausführbar sind und genannte Werkzeuge angemessene Anerkennung erhalten. Kürze Fülltext, unnötigen Fachjargon, wiederholte Einleitungen und Erklärungen, die über den Bedarf der Zielgruppe hinausgehen. Prüfe Überschriften, Sprachangaben der Codeblöcke, Links, Hervorhebung, Absatzlänge und Zeichensetzung. Ende mit Vorwärtsdrang: was als Nächstes ausprobiert werden kann, worauf zu achten ist oder wo es weitergeht.