20 Jahre MDN

• MDN Web Docs feiert sein 20-jähriges Bestehen und stellt die Tradition der Geburtstagskuchen in der Webbranche vor
• Browserhersteller pflegen die Tradition, sich zu wichtigen Meilensteinen trotz Konkurrenz gegenseitig Kuchen zu schicken
• Zum diesjährigen MDN-Geburtstag gab es Glückwünsche in Form eines Kuchengeschenks vom web.dev-Team
• Für die Entwicklung von MDN waren die Anstrengungen der weltweiten Community und von mehr als 100.000 Mitwirkenden entscheidend
• Auch in Zukunft wird der Einsatz für das gemeinsame Ziel betont, Entwickler zu stärken und ein besseres Web zu bauen

---

20 Jahre MDN Web Docs

Die Kuchen-Tradition der Webbranche

• Im Web-Ökosystem haben Geburtstagskuchen eine besondere Bedeutung
• Browserhersteller führen die Tradition fort, sich zu wichtigen Produktveröffentlichungen oder Meilensteinen gegenseitig Kuchen zu schenken
  • Microsoft schickte Mozilla zur Veröffentlichung von Firefox 2, 3 und 4 jeweils einen Kuchen
  • Auch Mozilla schickte Microsoft zur Veröffentlichung von IE10 einen Kuchen
• Diese Tradition ist ein Symbol, das die Webentwicklungskultur von Konkurrenz und Zusammenarbeit zugleich gut zeigt

Der Kuchen zum 20. Geburtstag von MDN

• Zum 20-jährigen Jubiläum von MDN gab es einen Gratulationskuchen vom web.dev-Team
• Das MDN-Team bedankt sich beim web.dev-Team für den leckeren Kuchen sowie bei allen Partnern, Kolleginnen und Kollegen und der Community, die MDN zu dem gemacht haben, was es heute ist

Die MDN-Community und globale Partnerschaften

• Für die Entwicklung von MDN spielten die Aktivitäten von zahlreichen Entwicklerinnen und Entwicklern sowie mehr als 100.000 Mitwirkenden eine große Rolle
• Viele Beteiligte konnten nicht einzeln erwähnt werden, doch dank ihrer Leidenschaft, Neugier und direkten Beiträge konnte MDN wachsen

Der Blick nach vorn

• Das MDN-Team betont sein Ziel, Entwicklerinnen und Entwickler weltweit zu stärken und gemeinsam ein besseres Web aufzubauen
• Auf Grundlage der Erfahrungen der vergangenen 20 Jahre erwartet das Team, auch in den kommenden 20 Jahren unter demselben Ziel weiter zusammenzuarbeiten und zu wachsen

[GN⁺]

Hacker-News-Kommentare

• MDN ist definitiv eine wichtige Referenz. Diese komplexen modernen Webtechnologien zu dokumentieren, ist keine leichte Aufgabe, und das wird wirklich gut gemacht. Ich habe aber zwei kleine Kritikpunkte. Erstens lese ich auf MDN gelegentlich Inhalte, die etwas fragwürdig wirken. Zum Beispiel sehe ich in den Tutorials zu JavaScript-Frameworks und -Bibliotheken keinen besonderen Mehrwert gegenüber den offiziellen Tutorials. Besonders das Svelte-Tutorial ist fünf Jahre alt und passt nicht mehr zur heutigen Situation. Zweitens ist die Qualität der WebExtension-Dokumentation enttäuschend. Das meiste basiert auf Manifest v2, und v3 oder Chrome-Kompatibilität werden nur unvollständig erwähnt. Tatsächlich habe ich beim Entwickeln mit dieser Dokumentation schließlich zur offiziellen Chrome-Dokumentation wechseln müssen. Dabei war Firefox sogar mein Hauptziel
  • Ich gehöre zum MDN-Team. Vielen Dank für das Lob und das Feedback! Ich werde diese Punkte unbedingt mit dem Team teilen. Wenn du mehr über die Entwicklung von Firefox-Erweiterungen lernen möchtest, ist extensionworkshop.com wahrscheinlich hilfreich
  • Ich stimme stark zu, dass es auf MDN manchmal fragwürdige Inhalte gibt. MDN muss deutlich länger Bestand haben als nutzerseitige Bibliotheken oder Frameworks. Da frage ich mich, ob Vercel einen Weg finden wird, MDN-Nutzer in das eigene Framework zu lenken
• Ich freue mich wirklich, dass MDN noch lebt und weiterhin aktualisiert wird. Ich dachte, 2020 sei das ganze Team entlassen worden, und frage mich, ob das Team danach wieder aufgebaut wurde. Zugehörige HN-Diskussion
  • Ich bin im MDN-Team. Damals war das Team vorübergehend auf zwei Personen und einige Auftragnehmer geschrumpft, aber inzwischen sind wir deutlich gewachsen. Aktuell halten 15 Festangestellte, Auftragnehmer und ein breites Netzwerk aus Partnern und Mitwirkenden MDN auf dem neuesten Stand. Hier ist unser Team
  • Diese Situation ist wirklich irritierend. Mozilla hat das gesamte Team entlassen, also verstehe ich nicht, warum eine Mozilla-Domain den Geburtstag von MDN feiert
  • Ein großer Teil der MDN-Dokumentation ist OpenWebDocs zu verdanken. Dahinter stehen Freiwillige und verschiedene Tech-Unternehmen. openwebdocs.org
  • Der Code ist offen, also kann man direkt nachsehen, wer wie beiträgt. In den Beitragsstatistiken sieht es so aus, als seien viele der wichtigsten jüngsten Mitwirkenden keine Mozilla-Mitarbeiter, sondern Leute von Yale, Freelancer (vermutlich von Mozilla bezahlt) und Personen aus verschiedenen Unternehmen
• Dank MDN konnte ich als Erwachsener selbst ein Spiel im Stil der Space Invaders bauen, das ein Kindheitstraum von mir war. Dank der großartigen Dokumentation zur Canvas API und zu OscillatorNode war der Einstieg in die Spieleentwicklung wirklich leicht. Siehe auch mein Spiel und die Motivation hinter dem Projekt
  • Das Spielgefühl war wirklich hervorragend. Das Tempo der Gegner, ihre Anzahl, wie schnell sie herunterkommen – der Fortschritt fühlte sich gut an, und dass man auf die Kugeln der Gegner schießen kann, hat Spaß gemacht. Ich weiß nicht genau, wie groß der Unterschied zum originalen Invaders ist, aber für eine kurze Pause war es eine großartige Erfahrung. Danke dafür
  • Es freut mich sehr, dass MDN dir dabei geholfen hat, deinen Traum zu verwirklichen! Ich werde das Feedback unbedingt ans Team weitergeben
• Seit fast 20 Jahren nutze ich MDN als meine meistverwendete Web-Dokumentation. MDN ist eine unverzichtbare Ressource. Es ist viel leichter zu lesen als die offiziellen Spezifikationen und bietet praktische Beispiele, Querverweise und sogar einen einfachen Playground. Dadurch bleibt es konstant nützlich
• Wenn ich auf MDN eine unbekannte Funktion lerne, ist das oft nicht einfach. Manchmal lese ich eine Dokumentation und frage mich: „Für wen ist das eigentlich geschrieben?“ Selbst nach zwei Absätzen habe ich oft noch kein Gefühl dafür, was diese Funktion ist oder welches Problem sie lösen soll. Wenn man das Thema nicht ohnehin schon im Detail kennt, bleibt nach dem Lesen kaum etwas hängen. Manchmal liefert sogar die Spezifikation mehr Hintergrundinformationen. Ich freue mich trotzdem, dass es MDN gibt, aber ich wünschte, es wäre so klar erklärt wie in CSS: The Definitive Guide. Mit der MDN-Dokumentation konnte ich über ein Jahr lang CSS nicht richtig lernen, aber nachdem ich CSS: The Definitive Guide gelesen hatte, habe ich es in drei Monaten vollständig verstanden. Wenn es ein System gäbe, das Erklärungen auf diesem Niveau kontinuierlich ausbaut und als Wiki pflegt, während die Informationen durch die aktuellen MDN-Referenzen auf dem neuesten Stand bleiben, würde ich sogar dafür bezahlen
  • Ich bin Mitglied des MDN-Teams. Vielen Dank für dieses wertvolle Feedback. Ich werde es unbedingt mit dem Team teilen und als Verbesserungspunkt mitnehmen. Zur Frage „Für wen ist diese Dokumentation gedacht?“: Die meisten unserer Referenzseiten basieren auf tatsächlichen Browser-Implementierungen. Wir dokumentieren nicht nur Spezifikationen, sondern konzentrieren uns auf Funktionen, die in mehreren Browsern eingeführt wurden. Wir bemühen uns, diese Informationen klar und neutral zu vermitteln, sodass sie für Menschen in jeder Entwicklungsphase zugänglich sind. Daneben haben wir in letzter Zeit auch viele Lerninhalte für Einsteiger ausgebaut. Dazu gehören Curricula, die einzelne Entwickler in ihrer jeweiligen Wachstumsphase unterstützen, und vertiefende Themen, die wir im Blog ergänzen
  • Vor 4–5 Jahren funktionierten einige MDN-Beispiele in echten Browsern nicht, und die Unterschiede zwischen der fit-content-Funktion und dem Keyword wurden mehrdeutig erklärt, sodass ich ein Issue gemeldet habe. Danach wurde die Dokumentation korrigiert. Aber inzwischen scheint es nicht mehr so zu funktionieren, auf diesem Weg Issues zu melden und Korrekturen zu bekommen. Es braucht einen neuen Feedback-Kanal oder Prozess für Korrekturen. Früheres Issue-Beispiel
• Ich finde es etwas seltsam, ausgerechnet in Jubiläumskommentaren Beschwerden loszuwerden, obwohl es ein kostenloser Dienst ist. Ich nutze die MDN-Dokumentation seit über fünf Jahren, und sie ist für mich eine wirklich wertvolle Ressource, die zugleich ganz natürlich zu vielen Experimenten anregt. Dank MDN habe ich tolle APIs und Funktionen entdeckt, von denen ich sonst nie erfahren hätte. Glückwunsch zum 20. Jubiläum
  • Das erinnert mich an Stroustrups Aussage, dass es nur Sprachen gibt, über die sich Leute beschweren, und Sprachen, die niemand benutzt. Gerade weil MDN wirklich ein notwendiger Dienst ist, haben viele Menschen unterschiedliche Meinungen dazu. Ich arbeite nur ein wenig mit der Webplattform, aber im Vergleich zu anderer Dokumentation hat sich MDN für mich immer erfrischend angefühlt
• MDN ist eine wirklich nützliche Ressource. In den letzten 15 Jahren habe ich ungefähr einmal im Monat bei DuckDuckGo den Befehl !mdn Array benutzt
  • Die Community hat auch den Redirect mdn.io/array eingerichtet, den kannst du ebenfalls verwenden!
• Ich frage mich, ob es eine Möglichkeit gibt, MDN direkt zu unterstützen. Ich möchte nicht allgemein an Mozilla spenden, sondern zweckgebunden, sodass klar ist, dass das Geld für den Betrieb von MDN verwendet wird. So unverzichtbar ist MDN für mich
  • Auf Firefox bin ich ebenfalls täglich angewiesen. Aber von Mozilla als Organisation bin ich zunehmend enttäuscht. Es enttäuscht mich, dass Ressourcen in Dinge fließen, die nichts mit Firefox zu tun haben, und bis die Prioritäten wieder stimmen, habe ich keine Bereitschaft zu weiterer Unterstützung
• Ich nutze MDN wirklich gern. Falls das Team diese Kommentare liest, möchte ich eine Erfahrung teilen, bei der mir die SVG-Dokumentation etwas unpraktisch vorkam. Die Beschreibungen der SVG-Elemente wirkten zu knapp. Zum Beispiel ist auf der Erklärungsseite zum Element g nicht ausreichend verlinkt oder erläutert, welche Attribute verwendet werden können und was globale Attribute sind. Auf der Seite sollte man die Attributliste leicht erfassen können, aber stattdessen muss man selbst danach suchen, was umständlich ist. Wenn man auf „attributes“ klickt, erhält man zwar die vollständige Attributliste, aber es ist nicht klar ersichtlich, welche davon global sind. Diese Struktur wirkt ungewohnt, und bei API-Struktur-Dokumentation würde ich erwarten, dass jede Property direkt auf der jeweiligen Strukturseite erklärt wird. Wie in der Dokumentation zu HTMLCanvasElement sollte zumindest klar auf einen Blick ersichtlich sein, welche Attribute elementspezifisch und welche geerbt sind. Solche Teile ließen sich wahrscheinlich zu einem erheblichen Teil halbautomatisch aus IDL erzeugen
• Als ich MDN zum ersten Mal entdeckte, fühlte es sich an, als würde ich heimlich in die geheime Bibliothek eines Zauberers eindringen und alte Bücher lesen. Mozilla-Team, ihr macht wirklich großartige Arbeit