21 private links
-
Sprecher und Thema:
Alanna Burke von amazee.io diskutiert in einem YouTube-Video mit dem Titel "Creating a Culture of Documentation" die Bedeutung von Dokumentation und deren verschiedene Verwendungszwecke für Kunden, neue Mitarbeiter und Unternehmen. -
Vorteile guter Dokumentation:
Burke betont die Vorteile einer qualitativ hochwertigen Dokumentation, darunter Klarheit, einfaches Verständnis und Genauigkeit. -
Zielgruppenansprache:
Sie unterstreicht die Bedeutung der richtigen Ansprache der Zielgruppe, damit die Dokumentation für Endbenutzer, Administratoren oder Entwickler genau und nützlich ist.- Beispiele für effektive Dokumentation:
Burke nennt Beispiele für effektive Dokumentation, darunter gut gestaltete Kubernetes-Dokumentation, Twilios Hauptdokumentationsseite und ein Feedback-System für Code-Bereitstellung.
- Beispiele für effektive Dokumentation:
-
Häufige Probleme schlechter Dokumentation:
Sie diskutiert die häufigen Probleme, die zu schlechter Dokumentation führen, wie das Fehlen von Anweisungen, die Verwendung von Fachjargon und Metaphern, die für andere nicht verständlich sind, falsche Zielgruppenanpassung und Fragmentierung der Dokumentation. -
Konsequenzen schlechter Dokumentation:
Die genannten Konsequenzen umfassen geringe Zufriedenheit und Produktivität am Arbeitsplatz, mangelnde Klarheit und Fehler im Produkt. -
Lösungsansätze:
Wenn Dokumentation nicht funktioniert, schlägt Burke drastischere Maßnahmen vor, wie das Nichtakzeptieren von Merge-Anfragen ohne Aktualisierung der Dokumentation oder die Integration der Dokumentation in die offiziellen Aufgabenbeschreibungen der Teammitglieder. -
Verantwortung für Dokumentation:
Sie betont, dass die Erstellung von Dokumentation die Verantwortung aller ist, beginnend mit ihrer Aufgabenbeschreibung, um sicherzustellen, dass die Leute den Wert des Produkts verstehen und sich verpflichten, die Dokumentation aktuell zu halten und zu schreiben, um sicherzustellen, dass sie es ordnungsgemäß verstehen. -
Handlungsaufruf:
Burke ermutigt die Zuhörer dazu, aktiv zu werden, und bietet Ressourcen wie eine Sketch-Präsentation sowie Videos und Folien aus ihren früheren Vorträgen zu diesem Thema an.
-
Domain Storytelling ist ein Workshop-Format, das dazu dient, die Zusammenarbeit zwischen Menschen, Aktivitäten und Softwaresystemen in einem bestimmten Bereich zu verstehen, insbesondere in Software- und Produktentwicklungsprojekten.
-
Das Video verwendet das Beispiel der Organisation einer Investitionskonferenz, um die Anwendung von Domain Storytelling zu illustrieren. Es zeigt, wie wichtig Kommunikation ist und wie verschiedene Modellierungstools und -techniken verwendet werden können, um komplexe Prozesse darzustellen.
-
Zusammengefasst ermöglicht Domain Storytelling ein gemeinsames Verständnis und verbessert die Zusammenarbeit und das umfassende Verständnis innerhalb eines Teams bei der Entwicklung von Software und Produkten.
In diesem Video wird das Konzept des Domain Storytelling vorgestellt, welches als Workshop-Format verwendet wird, um den Teilnehmern dabei zu helfen, die Zusammenarbeit zwischen Menschen, Aktivitäten und Softwaresystemen in einem bestimmten Bereich zu verstehen. Es ist insbesondere hilfreich bei Software- und Produktentwicklungsprojekten, um zu klären, welche Software entwickelt werden soll und wie sie genutzt wird. Das Video illustriert das Domain Storytelling am Beispiel der Organisation einer Investitionskonferenz und erklärt dabei die Aufgaben des Koordinators, die Schritte für die Konferenzorganisation sowie die Kommunikations- und Terminplanungsprozesse mit Investoren und Verkäufern. Es wird betont, wie wichtig Kommunikation ist, welche Rolle eine Registrierungswebseite und Passwortschutz spielen. Das Domain Storytelling ermöglicht es, ein gemeinsames Verständnis zu schaffen und komplexe Prozesse effizient darzustellen. Es wird darauf hingewiesen, dass dafür verschiedene Modellierungstools wie beispielsweise ein kundenspezifisches Modellierungstool oder ein Whiteboard verwendet werden können und dass es mit anderen Modellierungstechniken wie Event Storming, Example Mapping und User Story Mapping kombiniert werden kann. Zusammenfassend ist Domain Storytelling ein wertvoller Ansatz, um den High-Level-Flow und die Details einer Domäne zu verstehen und zu kommunizieren, um die Zusammenarbeit und das umfassende Verständnis zwischen dem Team zu verbessern.
Ryan Holiday erörtert in seinem Video über die Meditation von Marcus Aurelius über die Sterblichkeit die Bedeutung der Praxis des memento mori oder der Erinnerung an die eigene Sterblichkeit. Diese Praxis hilft dabei, gute Dinge mit Demut anzunehmen und schlechte Dinge mit Gleichgültigkeit loszulassen, was es den Menschen letztendlich ermöglicht, in der Gegenwart zu leben und jeden Moment zu schätzen. Holiday ist der Ansicht, dass die Menschen durch die Anerkennung der Unvermeidlichkeit des Todes die Angst und die Verleugnung ablegen und sich darauf konzentrieren können, im Augenblick präsent zu sein, jeden Tag alles zu tun, was sie können, um ihre Ziele zu erreichen, und die Arbeit zu würdigen, die sie bis zum gegenwärtigen Moment geleistet haben. Insgesamt erinnert memento mori die Menschen daran, das Leben in vollen Zügen zu leben und ihre Zeit nicht mit Dingen zu verschwenden, die nicht wichtig sind.
How a new & much simpler approach called 2-Sigma Observability can massively reduce the number of false positive alerts & uncover some undetectable issues
Integrated tests are a scam. You’re probably writing 2-5% of the integrated tests you need to test thoroughly. You’re probably duplicating unit tests…
Make Impact, Not Software. I call this ‘The GPS Talk’
In this session you'll learn novel techniques that help you make sense of large codebases.
You'll learn to identify the code that really matters for your ability to maintain a system, how to prioritize improvements [...]
Full talk title: Being glue
Your job title says "software engineer", but you seem to spend most of your time in meetings. You'd like to have time to code, but nobody else is onboarding the junior engineers, updating the roadmap, talking to the users, noticing the things that got dropped, asking questions on design documents, and making sure that everyone's going roughly in the same direction. If you stop doing those things, the team won't be as successful. But now someone's suggesting that you might be happier in a less technical role. If this describes you, congratulations: you're the glue. If it's not, have you thought about who is filling this role on your team?
Every senior person in an organisation should be aware of the less glamorous - and often less-promotable - work that needs to happen to make a team successful. Managed deliberately, glue work demonstrates and builds strong technical leadership skills. Left unconscious, it can be extremely career limiting. It pushes people into less technical roles and even out of the industry.
This is my annual guide to take you from start to finish when it comes to the web development technologies that are available for frontend, backend, and full-stack developers.