Zum Hauptinhalt Zur Navigation Zur Suche

Ersatz für MSDN und Technet: Neue Microsoft-Dokumentation ist Open Source

Mit einer komplett neuen Plattform für seine Dokumentation will Microsoft viele Probleme bei Technet und MSDN lösen. Sämtliche Einträge werden Open Source und ermöglichen Beiträge von Externen.
/ Sebastian Grüner
15 Kommentare Auf Google folgen (öffnet im neuen Fenster)
Microsoft hat seine Dokumentation komplett überarbeitet. (Bild: Microsoft)
Microsoft hat seine Dokumentation komplett überarbeitet. Bild: Microsoft

Sowohl Technet als auch das Microsoft Developer Network (MSDN) nutzen eine mehr als zehn Jahre alte "zerbrechliche Codebasis mit einem archaischen" System zur Veröffentlichung, schreibt Microsoft in einer Ankündigung(öffnet im neuen Fenster). Da dieses System nicht an moderne Techniken angepasst werden könne, startet das Unternehmen eine völlig neue Plattform zur Dokumentation seiner vielen Dienste, Anwendungen und Schnittstellen.

Mit dem Neustart wird die gesamte Dokumentation, die auf der Seite docs.microsoft.com(öffnet im neuen Fenster) veröffentlicht wird, Open Source. Andere Abteilungen von Microsoft haben dies bereits zuvor umgesetzt. Dazu gehören jene von Azure oder Asp.NET und .NET Core. Jeder Eintrag verfügt zudem über eine Schaltfläche zum Bearbeiten der Artikel. Mögliche Veränderungen und Erweiterungen durch externe Entwickler können so als Pull-Request über Github an das zuständige Team weitergeleitet werden.

Design soll Arbeit mit Dokumentation vereinfachen

Die neue Plattform soll vor allem dazu dienen, die Dokumentation leichter zugänglich zu machen. Dank des neuen Designs sollen sich die Einträge besser lesen lassen. Diese sind zudem wesentlich kürzer gehalten als bisher und es werden nun sprechende URLs verwendet statt einer eher kryptischen Kombination aus Buchstaben und Zahlen.

Darüber hinaus sind die Artikel nun in logische Kategorien sortiert, wodurch diese schneller aufgefunden werden sollen. Das Webseiten-Design passt sich an das Browser-Fenster an und die Seite soll deutliche schneller laden. Die neue Plattform läuft vollständig auf Microsofts Cloud-Dienst Azure.

Zurzeit findet sich auf der neuen Plattform ausschließlich Dokumentation der Enterprise-Mobility-Sparte. Das Team plant, immer mehr Dokumentation auf die neue Plattform zu migrieren.


Relevante Themen