#135 Design Documents & RFCs: Der Weg zu besserer Software-Architektur

Design Documents und Request for Comments (RFCs): Die Engineering Art der Planungsphase

Wir alle haben schon mal von einer Planungsphase gehört, um ein neues Projekt zu starten, und denken dabei an aufgeblasene Prozesse und lange Wasserfall-Diagramme. Und das Engineering-Team fragt sich oft: Wann kommen wir endlich mal zu den Details?

Da kommen die Begriffe Design Documents und Request for Comments (RFCs) ins Spiel.

Das doofe nur … Jemand muss diese Dokumente auch schreiben.

Und da sind wir bei gleich zwei von Andy's Lieblingsthemen: Schreiben und Design Docs.

Wir klären, wozu Design Documents eigentlich gut sind, worauf es ankommt, wo der Unterschied zu RFCs ist, ob das ganze nicht ein riesiger Wasserkopf ist, um einfach Dinge auf die Straße zu bringen und welche Kultur das ganze benötigt.

Viel Spaß.

Bonus: Wer schreibt, der bleibt.

Das schnelle Feedback zur Episode:

👍 (top)  👎 (geht so)

Feedback

• EngKiosk Community: https://engineeringkiosk.dev/join-discord 
• Buy us a coffee: https://www.buymeacoffee.com/engineeringkiosk
• Email: stehtisch@engineeringkiosk.dev
• LinkedIn: https://www.linkedin.com/company/engineering-kiosk/
• Mastodon: https://podcasts.social/@engkiosk
• Twitter: https://twitter.com/EngKiosk

Gerne behandeln wir auch euer Audio Feedback in einer der nächsten Episoden, einfach die Audiodatei per Email an stehtisch@engineeringkiosk.dev.

Links

• RFC und Design Doc Templates von verschiedenen Firmen: https://blog.pragmaticengineer.com/rfcs-and-design-docs/
• Public RFCs von SourceGraph: https://drive.google.com/drive/folders/1zP3FxdDlcSQGC1qvM9lHZRaHH4I9Jwwa?ref=blog.pragmaticengineer.com
• RFC Proposal von SourceGraph: https://docs.google.com/document/d/1zInJ9mn_SePKjS8dLHS1EDt2_gUEkCKD544bDDSuJek/edit#heading=h.trqab8y0kufp
• RFC Process von SoundCloud: https://philcalcado.com/2018/11/19/a_structured_rfc_process.html
• RFCs von RazorPay: https://github.com/razorpay/blade/tree/master/rfcs
• RFCs von Couchbase: https://github.com/couchbaselabs/sdk-rfcs/tree/master/rfc
• How to write an effective design document: https://rinaarts.com/how-to-write-an-effective-design-document/
• Design Docs at Google: https://www.industrialempathy.com/posts/design-docs-at-google/
• Design Documents vom Service Mesh Istio: https://github.com/istio/istio/wiki/Design-Doc-Links
• Kafka Improvement Pro