BT

Diffuser les Connaissances et l'Innovation dans le Développement Logiciel d'Entreprise

Contribuez

Sujets

Sélectionner votre région

Accueil InfoQ Actualités Le Projet Open Source docs.microsoft.com vient remplacer MSDN/TechNet

Le Projet Open Source docs.microsoft.com vient remplacer MSDN/TechNet

Favoris

Après 15 ans de service sur la même base de code, Microsoft a enfin décidé de supprimer MSDN et TechNet. Le remplaçant sera un projet open source nommé docs.microsoft.com. Jeff Sandquist écrit à ce propos :

En bref, le contenu est important. Nous avons échangé avec des centaines de développeurs et professionnels du milieu et passé au crible les dernières années de feedback sur UserVoice. Changer était une nécessité et il fallait créer une expérience moderne sur le contenu. Nous avons commencé par évaluer l'infrastructure de contenu actuelle de TechNet et MSDN. Les deux sites sont construits sur un socle fragile de 10-15 ans avec un système de publication et de déploiement archaïque non prévu pour le cloud.

Notre attention n'était pas seulement sur l'expérience, mais aussi sur la création de contenu et la manière dont vous le consommez. Depuis des années, les clients nous disent de dépasser les frontières du texte pour entrer au niveau du contenu des fonctionnalités et de les aider à implémenter des solutions à leurs problèmes. Nous savions que le contenu à venir et la plateforme en construction devaient faciliter l'apprentissage et le déploiement de solutions pour nos clients.

En dehors des difficultés de lisibilité classiques telles que la taille de colonne et le choix de police, le nouveau site incluera un timestamps et un temps prévisionnel de lecture pour chaque article. Le premier répond à un problème de MSDN/TechNet, où il faut attendre la fin d'un long article pour comprendre que la solution ne s'applique qu'à une version ancienne d'un produit. Le temps de lecture en soi n'est pas important, mais Microsoft souhaite l'utiliser pour affiner la longueur des articles pour qu'ils ne soient pas démesurément grands.

Toute la documentation de docs.microsoft.com est open source

Dans le passé, Microsoft proposait des fonctionnalités “Community Additions”, dont le support était hasardeux. Par exemple, les commentaires de la page .Net 3.5 pour la classe ReaderWriterLockSlim ne correspondent pas à ceux de la page .Net 4.0 pour la même classe. Et la fonctionnalité de commentaires est juste absente sur la page de la version actuelle.

Plutôt que de continuer dans cette voie, chaque page aura un bouton Edition grâce auquel les lecteurs pourront directement modifier le markdown et soumettre une pull request. En fait, vous pouvez même télécharger le repo git actuel qui stocke la documentation.

Pour des changements plus informels, ils ont “conclu un partenariat avec Livefyre afin de fournir des commentaires et des notes pour tous les articles”.

Version démo et Feuille de route

Le périmètre de la version actuelle ne concerne que “Enterprise Mobility Documentation”. Au fil du temps, plus de contenu sera migré, avec des redirections depuis les anciennes pages MSDN/TechNet.

Evaluer cet article

Pertinence
Style

Contenu Éducatif

BT