Mise à jour sur la migration de MSDN et de TechNet vers docs.microsoft.com

  • Article

Ce billet a été rédigé par Jeff Sandquist, vice-président d’entreprise, relations avec les développeurs.

Aujourd’hui, nous sommes ravis de pouvoir vous donner des informations importantes sur la migration du contenu de MSDN et de TechNet vers docs.microsoft.com. Ce billet de blog décrit les dernières étapes d’un effort consenti à l’échelle de l’entreprise pour, d’une part, moderniser la structure du contenu, son format et son infrastructure sous-jacente et, d’autre part, regrouper toute la documentation technique de Microsoft autour d’un seul site.

De MSDN et TechNet à docs.microsoft.com

C’est en 1992 que le Microsoft Developer Network (MSDN) voit le jour, un service par abonnement proposant aux clients des informations techniques sur la programmation dans Windows. Six ans plus tard, en 1998, le site MSDN Online hébergeant plus de 250 000 pages de contenu est lancé.

Capture d’écran de MSDN Online en 1999

À cette date, le processus de publication consistait à créer du contenu dans Microsoft Word, à le convertir en HTML et à le publier via un outil appelé pubwiz (Assistant Publication). Pendant plus de 20 ans, le processus prend en charge la sortie de nouveaux produits, services et mises à jour, générant 45 millions de pages de contenu technique !

Mais à mesure que le cycle de lancement des produits passe de plusieurs années à quelques mois seulement, le besoin d’une documentation à jour et accessible se fait plus pressant. Pour que notre système de publication reflète la rapidité de nos ingénieurs, la gestion de la documentation chez Microsoft doit donc être réinventée et adaptée à l’ère du cloud. En novembre 2015, les membres fondateurs de l’équipe docs.microsoft.com, à savoir Dan Fernandez, Mary McHale, Carol Zeumault et Jeff Sandquist, rédigent un document intitulé « Un nouvel espoir » (en hommage à l’épisode IV de la Guerre des étoiles) pour présenter leur vision du nouveau site. Voici les principes directeurs clés de ce document :

  • Documentation technique unifiée. Le nouveau site doit regrouper les dizaines de sites web de documentation hébergés par Microsoft. Un développeur qui souhaite apprendre à créer une application web pilotée par les données doit être en mesure de visiter un seul site pour trouver tout le contenu dont il a besoin sur ASP.NET, Azure, Entity Framework ou une autre technologie Microsoft.
  • Meilleure expérience utilisateur. L’un des facteurs clés de la réussite d’un site web est l’expérience qu’il propose à ses clients. Le nouveau site doit présenter les caractéristiques suivantes : meilleures performances en termes de chargement, polices lisibles, tables de contenu accessibles, URL explicites, prise en charge de la gestion des versions et compatibilité avec les navigateurs mobiles. Il doit aussi respecter les pratiques de conception inclusive en proposant des fonctionnalités d’accessibilité et prendre en charge l’internationalisation.
  • Démocratiser la création et l’engagement de la communauté. Le nouveau site doit reposer sur des normes et des outils open source qui permettent à quiconque de créer et de modifier des documents. Il doit utiliser Markdown pour le contenu, YAML pour la documentation générée automatiquement sur les API et GitHub comme couche de contenu sous-jacente afin d’effectuer des contrôles qualité automatisés. L’organisation MicrosoftDocs sur GitHub compte désormais plus de 7 400 membres. Le dépôt de la documentation Azure est l’un des projets open source à la croissance la plus rapide (470 % par an) et le 5e dépôt en termes de contributions à l’échelle de GitHub (selon The State of the Octoverse 2018).
  • Prise en charge de la documentation sur les API. Le nouveau site doit prendre en charge de manière irréprochable la documentation des API écrites pour les langages de programmation et les plateformes qu’utilisent nos clients : .NET, Java, Python, JavaScript et TypeScript, PowerShell, Azure CLI, Q#, OpenAPI, etc. L’expérience doit être tirer parti de l’automatisation et offrir une couverture fiable des API. Elle doit également permettre de publier une documentation d’API en quelques minutes, et non en quelques semaines.
  • Moderniser l’infrastructure d’ingénierie. En exécutant docs.microsoft.com sur Azure, nous pouvons réduire les coûts de maintenance (plus de 7 millions de dollars économisés), améliorer les délais de déploiement (de toutes les trois semaines à tous les jours, voire plus) et réduire la redondance des travaux d’ingénierie.
  • Extensible par défaut. À mesure que le site évolue, il doit pouvoir répondre aux besoins de nos clients de la manière la plus efficace possible. Cet engagement nous a permis de façonner et d’intégrer une toute nouvelle expérience d’apprentissage interactif, Microsoft Learn, ainsi que notre propre navigateur d’exemples de code.

Une fois notre plateforme moderne en place, nous nous sommes fixé pour objectif de ne perdre aucun document important durant sa migration vers le nouveau site. Vous trouverez ci-dessous plus d’informations sur nos progrès.

Bibliothèques MSDN et TechNet

État : ✅ terminé

Nous avons commencé la migration de la bibliothèque MSDN et de la bibliothèque TechNet vers docs.microsoft.com fin 2017 et l’avons achevée cette année.

Ces bibliothèques proposaient de la documentation sur les produits Microsoft, notamment des documents sur les API, des exemples de code et des articles techniques. Disponible à l’origine sur CD, le contenu a ensuite été mis en ligne au moment du lancement des sites web MSDN et TechNet.

La migration a nécessité la conversion de divers formats basés sur XML au format Markdown pour le contenu géré par des humains et au format YAML pour la documentation automatisée sur les API (couvrant plus de cent ensembles de contenus différents). Nous avons vérifié les URL de redirection de millions de pages web afin d’éviter les liens rompus référencés dans des sites externes comme des blogs ou des forums.

Pour vous donner une idée du volume de contenu que nous avons traité, voici quelques statistiques :

Si vous avez marqué d’un signet du contenu MSDN ou TechNet, les liens seront redirigés en toute transparence vers leur nouvel emplacement sur docs.microsoft.com.

MSDN Magazine

État : ✅ terminé

Le dernier numéro de MSDN Magazine a été publié le 1er novembre 2019. Nous avons envoyé un dernier message aux lecteurs et aux auteurs dans l’édition d’août de MSDN Magazine.

Le contenu de MSDN Magazine publié sur MSDN a été transféré vers docs.microsoft.com/archive.

Les abonnés de MSDN Magazine qui ont payé leur abonnement seront remboursés au prorata, en fonction de la durée restante de leur abonnement. Les chèques de remboursement seront envoyés par courrier après la publication du numéro de novembre. Ce changement n’a aucun impact sur l’abonnement à la plateforme MSDN.

Bulletins d’informations Microsoft Developer et TechNet Flash

État : ✅ terminé

Les bulletins d’informations publiés sur MSDN et TechNet ont été transférés vers docs.microsoft.com/archive.

Les abonnés actuels continueront de recevoir ces bulletins d’informations, mais il est possible que nous changions leur format et leur calendrier de publication.

Si vous ne souhaitez plus recevoir nos bulletins d’informations, vous pourrez vous désabonner dans le prochain e-mail que vous recevrez.

Blogs MSDN et TechNet

État : ✅ terminé

Les sites hébergeant les blogs MSDN et les blogs TechNet sont en lecture seule depuis juillet 2019. Les blogs MSDN et TechNet ont été migrés et archivés dans docs.microsoft.com/archive.

Si vous avez marqué d’un signet des blogs MSDN ou TechNet, les liens vers ceux-ci seront redirigés vers le nouvel emplacement sur docs.microsoft.com/archive ou vers d’autres sites de blog s’ils sont activement gérés et mis à jour.

État : ✅ terminé

Nous avons redirigé toutes les pages de MSDN Code Gallery vers le navigateur d’exemples et archivé les exemples clés sur GitHub dans l’organisation MicrosoftArchive. Pour plus d’informations sur ce processus, lisez ce billet de blog.

Les exemples de code les plus récents se trouvent sur docs.microsoft.com/samples.

État : 🚧 en cours

La galerie TechNet sera mise hors service début 2020. En décembre 2019, le site passera en lecture seule et n’acceptera plus les contributions de la communauté. Annonces et informations supplémentaires à suivre.

Utilisez docs.microsoft.com/samples pour accéder aux exemples de code les plus récents. Si vous avez déjà contribué à la galerie TechNet, veillez à migrer vos exemples vers un emplacement personnel comme votre propre dépôt GitHub.

Wiki TechNet

État : 🚧 en cours

Nous travaillons sur un plan et un calendrier de migration plus concrets pour Wiki TechNet. Revenez plus tard pour obtenir davantage de détails. Vous pouvez continuer à participer et à interagir avec le contenu wiki pour le moment.

Forums MSDN et TechNet

État : 🚧 en cours

Nous avons annoncé la préversion de Microsoft Q&A, qui remplace les forums MSDN et TechNet. Pour garantir une transition en douceur et minimiser les interruptions, nous avons divisé la migration en plusieurs phases. Nous prévoyons d’achever la migration d’ici la mi-2020. Revenez plus tard pour obtenir davantage de détails.

Canal 9

État : 🚧 en cours

Channel 9 continue d’être un investissement important pour le contenu vidéo destiné aux développeurs. Nous travaillons sur un chemin de migration permettant de mieux intégrer les vidéos et le contenu technique de Channel 9. Revenez plus tard pour obtenir davantage de détails.

Nous attendons vos remarques !

Nous sommes ravis de continuer à investir dans notre plateforme et de vous offrir la documentation technique la mieux adaptée et la plus fiable pour l’ensemble de l’écosystème Microsoft. Faites-nous part de vos idées et de vos suggestions sur GitHub et Twitter.