APIs als Produkt: Investitionen in die aktuelle und die nächste Generation der Beitragenden

Dies ist eine kurze Zusammenfassung eines Originalartikels, der im Juni 2025 im TechBlog veröffentlicht wurde.

Wikipedia feiert bald seinen 25. Geburtstag, und das wäre ohne die Gemeinschaft der technischen Freiwilligen bei Wikimedia nicht möglich gewesen. Diese Beitragenden entwickeln Tools, automatisieren Aufgaben und erweitern die Möglichkeiten in allen Wikimediaprojekten. 

Die Arbeit mit den technischen Systemen von Wikimedia war nicht immer einfach. Viele dieser Tools basieren auf den Web-APIs von Wikimedia – den Bausteinen oder digitalen Verbindungselementen, die die Kommunikation zwischen Software ermöglichen. Diese APIs sind zwar leistungsstark, wurden aber zu einer Zeit entwickelt, als die heutigen Webstandards gerade erst im Entstehen waren. Im Laufe der Jahre haben sie sich in unterschiedliche Richtungen weiterentwickelt, was sie manchmal verwirrend oder schwer zu bedienen machte, besonders für Neulinge. Bei einer kürzlich durchgeführten API-Listening-Tour fassten Entwickler dies oft so zusammen: „Wikimedia-APIs sind großartig, sobald man weiß, was man tut.“ Wir möchten es Entwicklern erleichtern, diesen Punkt zu erreichen, damit sie die APIs schneller effektiv nutzen können.

Warum wir uns auf APIs konzentrieren

APIs sind unverzichtbar für technische Freiwillige und Mitarbeitende der Wikimedia Foundation, die Tools, Bots und Features entwickeln, die Millionen von Menschen weltweit zugutekommen. Sind unsere APIs zu komplex oder uneinheitlich, erschwert dies den Einstieg für neue Autor/innen und bremst Innovationen. Wir sind der Meinung, dass Entwickler ihre Zeit mit der Entwicklung verbringen sollten, anstatt sich mit technischen Hürden herumzuschlagen.

Um dies zu ermöglichen, möchte die Wikimedia Foundation im Rahmen des Ziels „Verantwortungsvoller Umgang mit der Infrastruktur“ im Jahresplan für die Geschäftsjahre 2025–2026 (siehe: das Schlüsselziel WE5.2) in eine bessere und nachhaltigere API-Nutzung investieren. Das Ziel dieser Investition ist es, sowohl neue als auch erfahrene Entwickler zu unterstützen, damit sie leichter Beiträge leisten können und die Wikimediaprojekte auch in den kommenden Jahren florieren. Um dies zu erreichen, sehen wir drei Hauptbereiche, in denen wir die Nachhaltigkeit unseres API-Angebots verbessern können: Vereinfachung, Dokumentation und Kommunikation.

Vereinfachung der Benutzendenerfahrung

Im Laufe der Zeit haben sich die APIs von Wikimedia in viele verschiedene Richtungen weiterentwickelt, wodurch ein Flickenteppich aus Systemen entstanden ist, dessen Wartung und Verständnis recht knifflig sein kann. Um den Wartungsaufwand zu reduzieren und eine nahtlose Entwicklererfahrung zu gewährleisten, planen wir, die Funktionsweise unserer APIs einheitlicher zu gestalten und auf einen modernen, einheitlichen Ansatz umzusteigen. Das macht das Erlernen einfacher, die Wartung leichter und die Entwicklung neuer Tools schneller. Genau wie beim Aufräumen und bei der Organisation einer gut genutzten Werkstatt, damit jeder leichter findet, was er braucht, und schneller an die Arbeit gehen kann.

Verbesserung der Dokumentation

Eine klare, einheitliche und hilfreiche Dokumentation ist für eine offene und einladende Entwicklererfahrung unverzichtbar. Derzeit sind Informationen zu unseren APIs über verschiedene Projekte, generierte Websites und Kommunikationskanäle verstreut, was es Entwicklern erschweren kann, die benötigten Informationen zum richtigen Zeitpunkt zu finden. Wir arbeiten daran, eine einfachere, modernere Dokumentation zu erstellen, mit interaktiven Tools, die Entwicklern helfen, sich praktisch zu orientieren und zu lernen. Außerdem wollen wir sicherstellen, dass diese Informationen in mehr Sprachen verfügbar sind, damit jeder, egal wo er lebt, mitmachen kann.

Kommunikation von Veränderungen

Da sich unsere APIs ständig weiterentwickeln, brauchen Entwickler eine zuverlässige Möglichkeit, auf dem Laufenden zu bleiben. Wir werden ein zentrales Changelog erstellen, um Updates, neue Features und geplante Änderungen zu dokumentieren, damit niemand im Unklaren bleibt. Außerdem werden wir Entwickler einladen, neue Features frühzeitig und regelmäßig zu testen und uns Feedback zu geben, damit wir gemeinsam Lösungen entwickeln können, die ihren Bedarfen entsprechen. Über die Kommunikation hinaus werden wir proaktiv mit Entwicklern in Kontakt treten, indem wir uns in bestehenden Communities engagieren und gezielte Unterstützung für diejenigen anbieten, die Hilfe bei der Umstellung benötigen.

Wie geht’s weiter?

Wir stehen noch ganz am Anfang – wir machen gerade erst die ersten Schritte auf dem Weg zu einem einheitlichen API-Produktangebot. Aber wir hoffen, dass wir nächstes Jahr um diese Zeit gemeinsam darauf zusteuern.

Euer Engagement und eure Erkenntnisse sind für unseren weiteren Weg von entscheidender Bedeutung. Wir werden euch weiterhin über Mailinglisten, Diff, den TechBlog und andere technische Community-Kanäle auf dem Laufenden halten. Wir laden euch außerdem ein, euch aktiv einzubringen: Teilt eure Gedanken zum WE5-Ziel im Jahresplan mit, regt Diskussionen auf den Diskussionsseiten an, schaut euch die Folien der Session „Die Zukunft der Wikimedia-APIs“ beim Wikimedia Hackathon an, beteiligt euch an den Themen der kommenden Listening Tour oder kommt bei den nächsten Veranstaltungen wie der Wikimania Nairobi auf uns zu.

Technische Freiwillige spielen eine wesentliche Rolle für das Wachstum und die Entwicklung von Wikipedia sowie aller anderen Wikimediaprojekte. Gemeinsam können wir Entwicklern, die sich an ein Leben vor Wikipedia gar nicht mehr erinnern können, ein besseres Erlebnis bieten und dafür sorgen, dass die nächste Generation nicht ohne Wikipedia auskommen muss. Auf die nächsten 25 Jahre von Freiem Wissen!

Weitere Informationen findest du in diesem TechBlog-Artikel, der einen detaillierten Überblick über unsere API-Strategie bietet.