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

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. 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.

• 

Die neue (oben) und alte Dokumentation von Microsoft (Bild: Microsoft)

Mit dem Neustart wird die gesamte Dokumentation, die auf der Seite docs.microsoft.com 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.