Einführung in docs.microsoft.com

Dieser Beitrag wurde von Jeff Sandquist, General Manager in der Cloud + Enterprise Division geschrieben.

Heute kündigen wir die Vorschauversion unseres neuen Dokumentationsdiensts https://docs.microsoft.coman, in dem Inhalte vorgestellt werden, die unsere Enterprise Mobility-Produkte unterstützen.

Warum docs.microsoft.com?

Kurz gesagt, inhalt ist wichtig. Wir haben Hunderte von Entwicklern und IT-Experten interviewt und befragt und über Ihre Website Feedback über die Jahre über UserVoicegesiebt. Es war klar, dass wir eine Änderung vornehmen und eine moderne Weboberfläche für Inhalte erstellen müssen. Als Erstes haben wir unsere vorhandene Inhaltsinfrastruktur TechNet- und MSDN-ausgewertet. Beide Websites basieren auf einer 10-15-jährigen spröden Codebasis mit einem archaischen Veröffentlichungs- und Bereitstellungssystem, das nie für die Ausführung in der Cloud konzipiert wurde.

Unser Fokus lag nicht nur auf der Erfahrung, sondern auch auf den Inhalten, die wir erstellen und wie jeder von Ihnen es nutzt. Seit Jahren haben uns Kunden mitgeteilt, dass wir über die Wände von Text mit Inhalten auf Featureebene hinausgehen und ihnen helfen, Lösungen für ihre Geschäftsprobleme zu implementieren. Wir wussten, dass die von uns gelieferten Inhalte und die von uns erstellten Plattform den Kunden das Erlernen und Bereitstellen von Lösungen erleichtern müssen.

Wir haben erkannt, dass wir die Gesamterfahrung richtig machen müssen, um von Grund auf neu zu beginnen; aus diesem Aufwand kommt https://docs.microsoft.com – eine neue Hoffnung auf Dokumentation bei Microsoft.

Hinweis: Diese Vorschauversion der Website enthält Inhalte *only* for Enterprise Mobility Documentation (die aus Advanced Threat Analytics, Azure Active Directory, Azure Remote App, multi-factor Authentication, Azure Rights Management, Intuneund Microsoft Identity Manager). Da unsere Plattform mit Hilfe Ihres Feedbacks reift, werden wir zukünftig mehr unserer Dokumentation zu dieser Erfahrung migrieren.

Wichtige Features

Beginnen wir mit einer unten gezeigten Beispieldokumentationsseite, und wir präsentieren einige der neuen Features auf der Website.

Lesbarkeit

Um die Lesbarkeit von Inhalten zu verbessern, haben wir die Website so geändert, dass sie eine festgelegte Inhaltsbreite aufweist. Augenverfolgungsstudien gezeigt haben, dass Sie das Verständnis und die Lesegeschwindigkeit mit einer festgelegten Inhaltsbreite verbessern können, da es für das Auge schwierig ist, langen Passagen von links nach rechts zu folgen. Um dies in Aktion anzuzeigen, finden Sie unten ein Beispiel für einen Intune-Artikel, der auf docs.microsoft.com gefolgt vom gleichen Artikel auf TechNet ausgeführt wird. Wir haben auch den Schriftgrad für die linke Navigation und den Text selbst erhöht, etwas, das Kunden gefragt haben (UserVoice - Schriftgrad erhöhen).

Geschätzte Lesezeit

Eine weitere einfache Verbesserung, die wir basierend auf Ihrer Eingabe vorgenommen haben, besteht darin, eine geschätzte Lesezeit für einen Artikel bereitzustellen. Wir wissen, dass viele von Ihnen Technologie ein paar Minuten zwischen Besprechungen lernen/auswerten, und Sie sind wahrscheinlicher, Artikel zu lesen, wenn Sie wussten, wie viel Zeitverpflichtung erforderlich ist. Wir haben auch Datumsstempel zu Inhalten hinzugefügt, um Kunden zu verstehen, wie neu die Informationen auf UserVoice Feedback basieren.

Inhalt und Websitenavigation

Ein wichtiger Bereich der Investition basierend auf Kundeninterviews und UserVoice-Feedback waren Verbesserungen bei der Websitenavigation, Informationsarchitektur und Inhaltsorganisation basierend auf der Absicht des Kunden. Wir haben unsere Inhalte in logische Gruppierungen um die Bewertung, erste Schritte, Planung, Bereitstellung, Verwaltung oder Problembehandlung von Produkten oder Diensten umgestaltet. Sie können diesen Inhalt sowohl in der linken Navigationsleiste als auch auf unseren Produkt-/Serviceseiten aufschlüsseln.

Unten sehen Sie einen Screenshot der Intune-Dokumentation Startseite:

Screenshot

Die gleiche Kategorisierung befindet sich auch in der linken Navigation von Artikeln:

Gekürzte Artikellänge

Ein weiteres häufiges Feedback war, dass unsere Inhalte manchmal aufgrund ihrer Länge überwältigend sein können und dass lange Artikel schwieriger zu navigieren und zu finden, wonach Sie suchen. Um dies zu beheben, haben wir viele längere Artikel in kleinere logische Schritte unterteilt und die Schaltflächen "Zurück" und "Weiter" am Ende der Artikel bereitgestellt, um zwischen den Schritten in einem mehrteiligen Lernprogramm zu navigieren, wie unten gezeigt.

Während viele Kunden die Möglichkeit haben, mehrteilige Lernprogramme zu haben, haben wir auch von Kunden gehört, die die Möglichkeit haben, mehrstufige Lernprogramme in einem einzigen, offline druckerfreundlichen PDF zu kombinieren. Das haben wir noch nicht, aber es wird in Kürze in der Vorschau verfügbar sein.

Dynamisches Design

Um eine großartige Erfahrung auf mobilen Geräten, Tablets und PCs zu schaffen, wie Sie auf UserVoicegefragt haben, haben wir zu einem reaktionsfähigen Layout gewechselt. Wenn Sie auf die Schaltfläche "Optionen" klicken, wird sie erweitert/reduziert, um die gleichen Optionen in einer Desktopansicht anzuzeigen.

Beiträge der Gemeinschaft

Alle Dokumentationen zu docs.microsoft.com sind open sourced und sollen Communitybeiträge ermöglichen. Dies folgt in den Spuren anderer Teams bei Microsoft, die bereits alle oder Teile ihrer Dokumentation geöffnet haben, einschließlich ASP.NET, Azure, .NET Core-und Microsoft Graph.

Jeder Artikel verfügt über eine Schaltfläche "Bearbeiten" (siehe unten), mit der Sie zur Markdown-Quelldatei in GitHub gelangen, in der Sie ganz einfach eine Pull-Anforderung senden können, um Inhalte zu beheben oder zu verbessern.

Feedbackmechanismen

Ihre Fragen, Kommentare und Feedback sind uns wichtig. Wir haben mit [Livefyre](https://web.livefyre.com/) partnered to provide comments and Sidenotes on all of our articles. Oben in jedem Artikel sehen Sie einen Link zu Kommentaren wie unten dargestellt.

Link

Wenn Sie auf Kommentare klicken, gelangen Sie zum Ende der Seite, auf der Sie sich anmelden können (mithilfe von Twitter, Facebook, Google, Yahoo oder Microsoft-Anmeldeinformationen), um Kommentare hinzuzufügen, zu folgen oder zu liken.

Sie können auch Randnoten oder Notizen zu jedem Absatz von Inhalten oder speziell hervorgehobenen Text hinzufügen. Klicken Sie dazu mit dem Mauszeiger auf dem Kommentarsymbol auf der rechten Seite darauf, um einen Inlinekommentar hinzuzufügen.

Freigabe für soziale Netzwerke

Über die Schaltfläche "Teilen" oben auf der Seite können Sie ganz einfach mit Twitter und Facebook teilen.

Sie können auch den Mauszeiger verwenden, um Inhalte in einem Artikel auszuwählen, um einen Kommentar hinzuzufügen oder auf Twitter oder Facebook direkt aus dem Kontextmenü zu teilen, wie unten dargestellt.

Benutzerfreundliche URLs

Wir kümmern uns um unsere Weberfahrung und eine Sache, die uns regelmäßig als Benutzer von TechNet und MSDN gefehlert hat, ist, dass Artikel keine freundlichen, lesbaren URLs haben. Hier ist ein Beispiel für denselben Artikel mit unseren neuen URLs.

• Vor:<https://technet.microsoft.com/library/dn646983.aspx>

• Nach:<https://learn.microsoft.com/intune/get-started/start-with-a-paid-subscription-to-microsoft-intune>

Websitedesign

Außerdem wurde eine Designauswahl zu Artikeln hinzugefügt, sodass Sie zwischen einem hellen und dunklen Design wechseln können, was einige von Ihnen auf UserVoicegefragt haben.

Die folgende Abbildung zeigt den Unterschied zwischen dem hellen und dem dunklen Design.

Grundlagen

Grundlagen wie die Websiteleistung sind ein wichtiges Feature, und viele Kunden haben uns gebeten, UserVoicezu verbessern. Die Seitenladezeit auf docs.microsoft.com liegen zwischen 50 und 300% schneller in Bezug auf die Ladezeit, und wir sind besser geoverteilt als je zuvor. Wir haben auch eine Architektur entwickelt, die 100% in Azure ausführt.

Wir möchten Ihr Feedback!

Wir hoffen, dass Sie die Vorschauversion von docs.microsoft.com genießen, und senden Sie uns bitte Ihr Feedback an https://aka.ms/sitefeedback. In zukünftigen Beiträgen besprechen wir unsere Pläne, die Erfahrung für Referenzinhalte und unsere Pläne für die Inhaltslokalisierung erheblich zu verbessern.