Notes de publication – Janvier 2019
Cet article a été écrit par Den Delimarsky, Chef de programme au sein de la division Cloud and AI.
Voici un nouvel épisode des notes de publication sur docs.microsoft.com, le premier de 2019 ! Nous sommes ravis de pouvoir perfectionner nos expériences avec de nouveaux outils, des améliorations de notre contenu et davantage de contributeurs de la communauté !
Contributeurs de la communauté
Notre communauté est la clé de nombreuses améliorations de la documentation que nous hébergeons. Il y a de grandes chances, chaque fois que vous lisez un article sur docs.microsoft.com, qu’il ait bénéficié de la contribution de quelqu’un aussi soucieux que nous de la justesse et de la qualité générales de la documentation. Des centaines de personnes consacrent des heures à améliorer notre documentation ! Nous aimerions en citer quelques-uns dans le billet de blog de ce mois-ci.
Si vous voulez contribuer à notre contenu, commencez avec notre guide du contributeur.
Valeriy Novytskyy
Également connue sous le nom de 01binary sur GitHub, Valeriy a fait un travail fantastique pour notre documentation ASP.NET Core en améliorant les exemples de code de sécurité. Dans tous leurs projets et leurs explorations, les développeurs commencent par étudier les exemples de code, et nous sommes heureux de voir que ces exemples sont de plus en plus complets et fiables.
Dave Brock
Dave est un contributeur actif de la documentation ASP.NET Core. Il a envoyé plus de 10 demandes de tirage différentes en quelques mois pour que notre documentation soit plus juste et conviviale. Il est sur Twitter sous @daveabrock.
Lynn Park
Lynn est un nouveau contributeur de la documentation : sa première demande de tirage vient d’être fusionnée dans notre documentation Entity Framework ! Lectrice régulière de docs.microsoft.com, elle a décidé de donner en retour et a apporté vaillamment sa première contribution open source. Vous pouvez la trouver sur Twitter.
Versions de contenu
Avec l’augmentation de notre offre de produits, notre objectif est de toujours fournir la documentation la plus récente et la plus pertinente pour nos utilisateurs. Ce mois-ci, nous avons développé notre bibliothèque de contenu sur docs.microsoft.com avec l’ajout de la nouvelle documentation de l’API Java pour Azure Media Services, la documentation de l’API .NET pour Windows Server 2019, la documentation de l’API REST pour Data Lake Stockage Gen2 et une mise à jour de la documentation Cognitive Services QnA Maker Python.
Fonctionnalités
Extension de markdownlint pour prendre en charge le Markdown personnalisé de la documentation
L’un des composants les plus populaires de Docs Authoring Pack pour VS Code est markdownlint du développeur Microsoft David Anson, qui permet aux contributeurs de vérifier que leur contenu suit les bonnes pratiques de Markdown. markdownlint est désormais extensible et l’équipe d’ingénierie Docs a commencé à ajouter des règles personnalisées pour prendre en charge les extensions Markdown pour la documentation. Ces règles sont installées dans le cadre de Docs Authoring Pack et, si vous utilisez le pack, vous n’avez donc rien à faire de particulier pour commencer le linting du Markdown de la documentation.
Plus d’options de linting personnalisées seront bientôt disponibles, y compris la vérification des liens sécurisés (https://) et le linting de la syntaxe des alertes de documentation, par exemple, [!NOTE], pour faciliter encore plus la contribution de nouveau contenu sur docs.microsoft.com !
Notes de bas de page
Plus de choses sont prévues pour cette année dans de nombreux domaines de notre espace de documentation ! Pour rester informé, suivez notre blog et notre compte Twitter. Si vous avez des suggestions de fonctionnalités ou des idées à nous proposer, n’oubliez pas d’ouvrir un nouveau ticket sur GitHub!