Présentation de docs.microsoft.com

Cet article a été écrit par Jeff Sandquist, Directeur Général de la division Cloud + Enterprise.

La préversion de notre nouveau service de documentation est aujourd’hui disponible sur / et présente le contenu prenant en charge nos produits Enterprise Mobility.

Pourquoi docs.microsoft.com ?

En bref, parce que le contenu est important. Nous avons interrogé des centaines de développeurs et professionnels de l’informatique. Nous avons aussi passé au peigne fin les commentaires que vous avez laissés au fil des années sur UserVoice au sujet de notre site web. La nécessité d’apporter des changements et de donner à notre contenu une expérience web moderne est clairement apparue. La première chose que nous avons faite a été d’évaluer notre infrastructure de contenu existante, à savoir TechNet et MSDN. Ces deux sites reposent sur un code base fragile. Ils ont été créés il y a 10 ou 15 ans au moyen d’un système de publication et de déploiement archaïque qui n’a pas été conçu pour le cloud.

Nous avons donc principalement porté notre attention sur l’expérience, sans toutefois négliger le contenu et la façon dont chacun d’entre vous le consomme. Pendant des années, nos clients nous ont demandé de dépasser le cadre du contenu sur les fonctionnalités et de les aider à implémenter des solutions aux problèmes qu’ils rencontrent dans leur entreprise. Nous savions donc que le contenu et la plateforme à mettre en place devaient permettre aux clients de découvrir et de déployer facilement des solutions.

Nous avons réalisé que pour obtenir une toute nouvelle expérience, il fallait tout recommencer à zéro. Le fruit de ces efforts : https://docs.microsoft.com, le nouveau visage de la documentation Microsoft.

Remarque : Cette préversion du site web inclut *uniquement* le contenu de la documentation Enterprise Mobility (qui regroupe Advanced Threat Analytics, Azure Active Directory, Azure Remote App, Multi-factor Authentication, Azure Rights Management, Intune et Microsoft Identity Manager). Une fois que la plateforme aura atteint sa maturité, notamment grâce à vos commentaires, nous prévoyons d’y migrer davantage de contenu.

Fonctionnalités clés

Commençons avec un exemple de page de documentation affiché ci-dessous. Il va nous permettre de présenter certaines des nouvelles fonctionnalités disponibles sur le site.

Documentation Example

Lisibilité

Pour améliorer la lisibilité du contenu, nous avons modifié le site de manière à appliquer une largeur fixe au texte. Des études de mouvement des yeux ont montré que nos yeux ont du mal à suivre de longs passages de gauche à droite, mais qu’il est possible d’améliorer la compréhension et la vitesse de lecture avec une largeur de contenu fixe. Pour le constater par vous-même, examinez l’exemple d’un article Intune dans docs.microsoft.com et dans TechNet. Pour répondre aux demandes des clients formulées sur UserVoice, nous avons également augmenté la taille de la police du volet de navigation gauche et du texte à proprement dit.

Docs and TechNet comparison

Estimation du temps de lecture

L’estimation du temps de lecture d’un article est une autre amélioration simple que nous avons apportée au vu de vos commentaires. Pour beaucoup d’entre vous, l’apprentissage ou l’évaluation de nouvelles technologies se limite à quelques minutes ici et là entre deux réunions. Vous êtes donc plus enclin à lire un article si vous savez à l’avance combien de temps il faut pour le lire. En réponse à d’autres commentaires laissés sur UserVoice, nous avons ajouté la date du contenu des articles pour que les clients sachent si les informations sont récentes.

Estimated reading time

Contenu et navigation du site

Les entretiens menés auprès des clients et l’analyse des commentaires UserVoice nous ont permis d’axer nos efforts sur quelques domaines clés, à savoir la navigation du site, l’architecture des informations et l’organisation du contenu en fonction de l’objectif du client. Nous avons ainsi restructuré notre contenu en plusieurs groupes logiques : l’évaluation, la prise en main, la planification, le déploiement, la gestion et le dépannage de produits ou de services. Ce contenu apparaît dans le volet de navigation gauche et dans les pages de nos produits et services.

Voici une capture d’écran de la page d’accueil de la documentation Intune :

Intune documentation screenshot

Les mêmes catégories se retrouvent dans le volet de navigation gauche des articles :

Left navigation

Raccourcissement de la longueur des articles

Bon nombre de commentaires soulignent la lourdeur de notre contenu, qui est souvent due à la longueur de nos articles. Il est vrai que des articles longs rendent la navigation difficile et ne facilitent pas la recherche d’informations. Pour résoudre ce problème, nous avons décomposé de nombreux articles longs en étapes logiques plus petites et fourni des boutons Précédent et Suivant en bas des articles pour naviguer entre les étapes d’un didacticiel composé de plusieurs parties, comme indiqué ci-dessous.

Back and Next buttons

Alors que de nombreux clients apprécient la possibilité d’avoir des didacticiels en plusieurs parties, certains clients nous ont fait savoir qu’ils souhaitent pouvoir combiner des didacticiels composés de plusieurs étapes en un seul et même fichier PDF imprimable en mode hors connexion. Nous n’offrons pas encore cette possibilité, mais cette option sera prochainement disponible dans la préversion.

Conception interactive

Comme vous nous l’avez signalé sur UserVoice, l’expérience doit être conviviale sur appareil mobile, sur tablette et sur PC. Nous sommes donc passés à une présentation interactive. Quand vous cliquez sur le bouton Options, le contenu est développé ou réduit, laissant apparaître les mêmes options que sur un poste de travail.

Responsive Page Design

Contributions de la communauté

Toute la documentation proposée sur docs.microsoft.com est open source, ce qui signifie que la communauté peut y contribuer. Cette démarche va dans le sens de celle adoptée par d’autres équipes de Microsoft qui proposent déjà tout ou partie de leur documentation en open source, comme ASP.NET, Azure, .NET Core ou Microsoft Graph.

Chaque article est doté d’un bouton Modifier, comme illustré ci-dessous, qui vous permet d’accéder au fichier texte source dans GitHub. À partir de là, vous pouvez facilement envoyer une requête d’extraction pour corriger ou améliorer le contenu.

Mécanismes d’obtention des commentaires

Vos questions, avis et commentaires nous intéressent ! Nous avons fait équipe avec Livefyre pour permettre l’ajout de commentaires et d’annotations à tous nos articles. En haut de chaque article se trouve un lien Commentaires, comme indiqué ci-dessous.

Comments link

Quand vous cliquez sur Commentaires, vous accédez à la partie inférieure de la page. Ici, vous pouvez vous connecter à l’aide de vos informations d’identification Twitter, Facebook, Google, Yahoo ou Microsoft pour ajouter, suivre ou approuver des commentaires.

Comments at bottom

Vous pouvez également ajouter des annotations ou des remarques à un paragraphe spécifique ou à une partie de texte mise en surbrillance. Pour cela, positionnez le curseur de la souris sur le symbole des commentaires situé à droite du texte, puis cliquez dessus pour incorporer un commentaire à l’article.

Sidenote example

Partage sur les réseaux sociaux

Le bouton de partage situé en haut de la page vous permet de partager facilement du contenu sur Twitter et Facebook.

Sharing to Twitter and Facebook

Vous pouvez également sélectionner le contenu d’un article à l’aide de la souris, puis ajouter un commentaire ou le partager sur Twitter ou Facebook directement à partir du menu contextuel, comme illustré ci-dessous.

Select and comment or share content

URL conviviales

L’expérience web est importante pour nous. Et en tant qu’utilisateurs de TechNet et de MSDN, le fait que les articles ne disposaient pas d’URL conviviales et lisibles était une source fréquente de frustration. Voici un exemple du même article avec nos nouvelles URL.

Thèmes du site web

Pour répondre aux commentaires formulés par certains d’entre vous sur UserVoice, nous avons ajouté aux articles un sélecteur de thème qui vous permet désormais de choisir entre un thème clair et un thème sombre.

Light and Dark Theme Selector

L’image ci-dessous montre la différence entre le thème clair et le thème sombre.

Light and Dark themes

Fondamentaux

L’amélioration de certaines fonctionnalités de base, comme les performances du site, a fait l’objet de nombreuses demandes de la part des clients sur UserVoice. Le chargement des pages sur docs.microsoft.com est 50 à 300 % plus rapide, et nous sommes mieux géodistribués que par le passé. Notre plateforme repose également sur une architecture qui s’exécute intégralement sur Azure.

Vos commentaires nous intéressent !

Nous espérons que la préversion de docs.microsoft.com vous donnera satisfaction. N’hésitez pas à envoyer vos commentaires à https://aka.ms/sitefeedback. Dans les prochains billets, nous vous parlerons de nos projets d’améliorer considérablement l’expérience du contenu de référence et de notre stratégie de localisation de contenu.