Aktualisieren der MSDN- und TechNet-Migration zu docs.microsoft.com

Dieser Beitrag wurde von Jeff Sandquist, Corporate Vice President, Developer Relations geschrieben.

Heute freuen wir uns, Ihnen ein wichtiges Update zur Migration von MSDN- und TechNet Inhalten zu docs.microsoft.com. Dieser Blogbeitrag dokumentiert die letzten Schritte eines unternehmensweiten Aufwands, um die Inhaltsstruktur, das Format und die zugrunde liegende Infrastruktur zu überarbeiten und die technische Dokumentation von Microsoft auf einer Website zu zentralisieren.

Von MSDN und TechNet zu docs.microsoft.com

Bereits 1992 wurde Microsoft Developer Network als Kundendienst geboren, um technische Informationen zur Programmierung für Windows bereitzustellen. Sechs Jahre später, 1998, wurde die MSDN Online-Website gestartet, die mehr als 250.000 Seiten mit Inhalten hosten.

Anschließend bestand der Veröffentlichungsprozess aus dem Erstellen von Inhalten in Microsoft Word, der Konvertierung in HTML und der Veröffentlichung über ein Tool namens pubwiz (Veröffentlichungs-Assistent). Seit über 20 Jahren unterstützte der Prozess die Veröffentlichung neuer Produkte, Dienstleistungen und Updates, was zu einer enormen Anzahl von 45 Millionen Seiten technischer Inhalte führt!

Da sich der Produktveröffentlichungszyklus von Jahren zu Monaten änderte, wuchs die Nachfrage nach barrierefreien up-to-Datumsdokumentation. Das Veröffentlichungssystem, das zur Übereinstimmung mit der Technischen Geschwindigkeit erforderlich ist, und daher haben wir beschlossen, die Dokumentation im Cloud-Zeitalter von Microsoft neu zu erfinden. Im November 2015, die Gründungsmitglieder des docs.microsoft.com Teams - Dan Fernandez, Mary McHale, Carol Zeumault, und Jeff Sandquist schrieb ein Dokument mit dem Namen "A New Hope" (eine Hommage an Star Wars Episode IV), die die Vision für die neue Website skizzierte. Sie umfasste eine Reihe wichtiger Leitprinzipien:

• Unified Technical Documentation. Die neue Website sollte die Dutzenden von Dokumentationswebsites konsolidieren, die von Microsoft gehostet werden. Ein Entwickler, der lernt, wie eine datengesteuerte Web-App erstellt wird, muss nur eine Website besuchen, um alle relevanten Inhalte zu ASP.NET, Azure, Entity Framework oder einer anderen Microsoft-Technologie zu finden.
• Verbesserte Benutzererfahrung. Ein wichtiger Faktor bei der Definition des Erfolgs einer Website ist die Erfahrung, die sie ihren Kunden bietet. Die neue Website sollte über eine bessere Ladeleistung, lesbare Schriftarten, barrierefreie Inhaltsverzeichnisse, lesbare URLs, Unterstützung für Versionsverwaltung, Kompatibilität mit mobilen Browsern verfügen und die Methoden des inklusiven Designs durch barrierefreie Features und Unterstützung für die Internationalisierungbefolgen.
• Demokratisieren von Autorisierung und Community-Engagement. Die neue Website sollte durch Open-Source-Standards und -Tools unterstützt werden, die es jedem ermöglichen, Dokumentationen zu erstellen und zu bearbeiten. Es sollte Markdown für Inhalte verwenden, YAML für die automatisch generierte API-Dokumentation und basiert auf GitHub- als zugrunde liegende Inhaltsebene, was die Verwendung automatisierter Qualitätsprüfungen ermöglichen würde. Die MicrosoftDocs GitHub-Organisation ist auf über 7.400 Mitglieder gewachsen, und das Azure-Dokumentations-Repository ist eines der am schnellsten wachsenden Open Source-Projekte (470% Jahr im Laufe des Jahres) und der 5. am häufigsten zu Repo in allen GitHub beigetragen, wie im State of the Octoverse 2018!
• Support-API-Dokumentation. Die neue Website sollte erstklassige Unterstützung für die Dokumentation von APIs haben, die für Programmiersprachen und Plattformen geschrieben wurden, die unsere Kunden verwenden, einschließlich .NET-, Java-, Python-, JavaScript- und TypeScript-, PowerShell-, Azure CLI-, Q#-, OpenAPI- und vieles mehr. Die Erfahrung sollte durch Automatisierung unterstützt werden, eine zuverlässige API-Abdeckung haben und in der Lage sein, DIE API-Dokumentation in Minuten statt wochen zu veröffentlichen.
• Modernisieren Sie die Engineering-Infrastruktur. docs.microsoft.com sollte auf Azure ausgeführt werden, sodass wir Wartungskosten reduzieren können (über 7MM gespeichert), die Bereitstellungszeiten von alle drei Wochen bis täglich (oder schneller) verbessern und Engineeringduplizierung reduzieren.
• Extensible standardmäßig. Da sich die Website weiterentwickelt, muss sie in der Lage sein, die Bedürfnisse unserer Kunden auf effizienteste Weise zu erfüllen. Durch diese Verpflichtung konnten wir eine völlig neue interaktive Lernerfahrung erstellen und integrieren – Microsoft Learn, sowie unsere Beispielcodebrowser.

Mit einer modernen Plattform stellen wir sicher, dass wir keine wertvollen Inhalte verlieren, indem wir sie zu der neuen Website migrieren. Im Folgenden finden Sie weitere Informationen zu unserem Fortschritt.

MSDN- und TechNet-Bibliotheken

Status: ✅ abgeschlossen

Wir haben die Migration von MSDN Library und TechNet Library ende 2017 zum docs.microsoft.com begonnen und die Migration in diesem Jahr abgeschlossen.

Die zuvor bereitgestellten Dokumentationen für Microsoft-Produkte, einschließlich API-Dokumentation, Beispielcode und technische Artikel. Ursprünglich über CDs verfügbar, wurden die Inhalte später mit der Einführung der MSDN- und TechNet-Websites online verschoben.

Die Migration erforderte die Konvertierung einer Vielzahl von XML-basierten Formaten in Markdown für vom Menschen bearbeitete Inhalte und YAML für automatisch generierte API-Dokumentationen, die über hundert verschiedene Inhaltssätze umfassen. Wir haben sichergestellt, dass Seitenumleitungen für Millionen von Webseiten vorhanden sind, um fehlerhafte Links zu verhindern, auf die außerhalb unserer Website verwiesen wird, z. B. Blogs und Foren.

Um Ihnen einen Einblick in die Menge der Inhalte zu geben, mit denen wir gearbeitet haben, sind hier einige Statistiken:

• Anzahl der verfügbaren MSDN- und TechNet-Themen: 45.4MM-
• Anzahl der zu docs.microsoft.com/previous-versionsmigrierten Themen: 23,0MM
• Anzahl der zu docs.microsoft.commigrierten Themen: 21,0MM-
• Anzahl der zum Hosten von docs.microsoft.com/previous-versions Inhalten erstellten Repositorys: 2.454

Wenn Sie msdn- oder TechNet-Inhalte mit einem Lesezeichen versehen haben, werden die Links nahtlos an ihren neuen Speicherort auf docs.microsoft.comumgeleitet.

MSDN Magazine

Status: ✅ abgeschlossen

Die letzte Ausgabe des MSDN Magazine wurde am 1. November 2019 veröffentlicht. Wir haben eine endgültige Nachricht an Leser und Autoren in der August Ausgabe des MSDN Magazinegesendet.

MSDN Magazine-Inhalte, die auf MSDN veröffentlicht wurden, wurden in learn.microsoft.com/archiveverschoben.

MSDN Magazine-Abonnenten, die für ihre Abonnements bezahlt haben, erhalten basierend auf der verbleibenden Zeit ihres Abonnements eine Anteilserstattung. Die Erstattungsprüfungen werden nach der Veröffentlichung der November-Ausgabe per E-Mail benachrichtigt. Diese Änderung wirkt sich nicht auf das MSDN-Plattformabonnement aus.

Microsoft Developer- und TechNet Flash-Newsletter

Status: ✅ abgeschlossen

Newsletter, die auf MSDN- und TechNet- veröffentlicht wurden, wurden in docs.microsoft.com/archiveverschoben.

Aktuelle Abonnenten erhalten diese Newsletter weiterhin. Wir können das Format sowie den Veröffentlichungszeitplan weiterentwickeln und ändern.

Wenn Sie unsere Newsletter nicht mehr abonnieren möchten, können Sie sich von der nächsten E-Mail abmelden, die Sie erhalten.

MSDN- und TechNet-Blogs

Status: ✅ abgeschlossen

Wir haben die MSDN Blogs und TechNet-Blogs Websites im Juli 2019 schreibgeschützt gemacht. MSDN- und TechNet-Blogs wurden zu docs.microsoft.com/archivemigriert und archiviert.

Wenn Sie ein Lesezeichen für MSDN- oder TechNet-Blogs erstellt haben, werden die Links zu diesen Websites entweder an den neuen Speicherort auf docs.microsoft.com/archiveoder auf andere Blogwebsites umgeleitet, wenn sie aktiv verwaltet und aktualisiert werden.

MSDN Code Gallery

Status: ✅ abgeschlossen

Wir haben alle MSDN Code Gallery-Seiten an den Beispielbrowser und archivierte Schlüsselbeispiele an GitHub in der MicrosoftArchive Organisation umgeleitet. Lesen Sie mehr über diesen Prozess in unseren letzten Blogbeitrag.

Die meisten up-to-Date-Codebeispiele finden Sie auf docs.microsoft.com/samples.

TechNet-Katalog

Status-: 🚧 In Bearbeitung

Die TechNet Gallery wird Anfang 2020 eingestellt. Im Dezember 2019 wird die Website schreibgeschützt gemacht, keine neuen Communitybeiträge mehr zu akzeptieren. Weitere Ankündigungen und Informationen, denen Sie folgen können.

Verwenden Sie docs.microsoft.com/samples, um die am häufigsten up-to-Date-Codebeispiele zu finden. Wenn Sie zuvor zum TechNet-Katalog beigetragen haben, stellen Sie sicher, dass Sie Ihre Beispiele zu einem persönlich verwalteten Speicherort migrieren, z. B. Ihrem eigenen GitHub Repository.

TechNet-Wiki

Status-: 🚧 In Bearbeitung

Wir arbeiten an einem konkreteren Migrationsplan und Zeitplan für TechNet Wiki. Weitere Details finden Sie später. Sie können zurzeit weiterhin an Wiki-Inhalten teilnehmen und mit ihnen interagieren.

MSDN- und TechNet-Foren

Status-: 🚧 In Bearbeitung

Wir haben die Vorschauversion von Microsoft Q&Aangekündigt, die MSDN- und TechNet-Foren ersetzt. Um einen reibungslosen Übergang zu gewährleisten und Unterbrechungen zu minimieren, haben wir die Migration in mehrere Phasen unterteilt. Wir erwarten, dass die Migration mitte 2020 abgeschlossen wird. Weitere Details finden Sie später.

Kanal 9

Status-: 🚧 In Bearbeitung

Channel 9 ist weiterhin eine wichtige Investition für entwicklerorientierte Videoinhalte. Wir arbeiten an einem Migrationspfad, der unsere Videos und technischen Inhalte aus Channel 9besser integrieren wird. Weitere Details finden Sie später.

Wir möchten von Ihnen hören

Wir freuen uns, weiterhin in unsere Plattform zu investieren und sicherzustellen, dass Sie die relevanteste und zuverlässige technische Dokumentation für das gesamte Microsoft-Ökosystem erhalten. Geben Sie uns Ihre Gedanken und Verbesserungsvorschläge zu GitHub und Twitter.