Der Vortrag von Peter Arrenbrecht behandelt die Bedeutung von verständlichen APIs und deren Dokumentation für die Qualität und Wartbarkeit von Software. Durch das Erklären von Anleitungen und das Testen von Beispielcode wird die Benutzerfreundlichkeit verbessert und die Zusammenarbeit gefördert. Wichtig ist der Fokus auf den Anwender sowie die Verwendung konsistenter Begriffe, um eine nachhaltige und effiziente API-Entwicklung zu gewährleisten.

1. “Stimmige APIs kosten weniger.” Peter Arrenbrecht

2. codewise.ch @parrenbrecht Literate Testing

3. Wir alle designen APIs Prüft Verbessert Einige von uns erklären sie auch Und wir testen sie

4. Ziel des Vortrags In diesem Vortrag geht es um das Erklären beim Schreiben von Anleitungen

5. Zeigen anhand von Beispielen

6. Prüfen der Beispiele in Tests

7. Aber eigentlich geht es darum, wie dies die Qualität von APIs verbessert.

8. Kosten eines schlechten APIs Getrieben durch Anzahl Anwendungen Auch in kleineren Teams relevant Schlecht lesbarer Code

9. Fehler in der Anwendung

10. Nachdenken bei jedem Anwenden

11. oder Copy/Paste von Unverstandenem

12. Vertrauensverlust

13. Ein schlecht designtes zentrales API kann eine Code-Basis massiv schädigen!

14. Zitat “ Good tests help you verify your code works , but good documentation forces you to question whether your code makes sense .” @sstephenson

15. Wie hilft das Erklären? Fokus auf Anwender und ihre Bedürfnisse Use Cases, User Stories Erweitert die Perspektive Zusammenspiel von Komponenten

16. Gesamtabläufe Bremst Featuritis Das muss nun auch noch alles erklärt werden

17. Erklären, die Zweite Fördert Zusammenarbeit Reviews der Usability des APIs

18. Vom Thron steigen Macht ehrlich und überzeugend Man muss für seine Arbeit einstehen

19. Speziell in Vorträgen!

20. Wie hilft das Zeigen? Beispielcode erzählt Teil der Geschichte