- Alle Entwickler schreiben guten Code, aber um ein besserer Ingenieur zu werden, sollte man seine Schreibfähigkeiten verbessern
Warum sollte man schreiben?
- Schreiben ist eine Methode, die Gedanken zu ordnen
- Schreiben ist eine Methode, etwas zu lernen
- Schreiben hilft dabei, Fehler zu entdecken
Wie kann man mehr schreiben?
- Wichtig ist: Lesen ist eine Gewohnheit, Schreiben ist eine Fähigkeit
- Um diese Fähigkeit zu meistern, muss man mehr schreiben
- Eine einfache Möglichkeit, mehr zu schreiben, ist, Design Reviews anders anzugehen
- Statt sie zu hassen und wie eine Hausaufgabe zu erledigen, sollte man sie mit Begeisterung angehen
- Jedes Mal, wenn man ein Design Review schreibt, sollte man versuchen, etwas zu verbessern
- Versuche, kürzer zu schreiben, ohne den Kern zu verlieren, und auch einmal ausführlicher, um mehr Use Cases abzudecken
- Wenn du dein Schreiben außerhalb der Arbeit verbessern willst, starte einen Blog
- Wenn dir ein Blog zu viel ist, beantworte Fragen auf Stackoverflow. Kopiere keinen Code, sondern konzentriere dich darauf, textliche Inhalte zu liefern
- Der letzte Rat lautet: kein Copy & Paste.
- Das Problem ist, dass alle einfach Befehle von GitHub/Google kopieren
- Wenn du Angst hast, unproduktiv zu wirken, denk daran, dass nicht die Menge des geschriebenen Codes oder wie schnell du Aufgaben abschließt der Maßstab für deine Bewertung ist
- Schreiben lässt sich nicht vermeiden. Ob man will oder nicht: Um ein 10x-Ingenieur zu werden, muss man schreiben
- "Schreibt Dokumentation, schreibt Design Reviews, erstellt Präsentationen. Je besser ihr im Schreiben werdet, desto schneller werdet ihr zu besseren Ingenieuren."
1 Kommentare
Google Technical Writing für Ingenieure [englisch]
Die 4 Grundprinzipien des Technical Writing
Die 10 Gebote des Technical Writing für Entwickler
Prinzipien für ein sauber abgeschlossenes Technical Writing