Notes de publication, février 2018
Cet article a été écrit par Dan Fernandez, Directeur Général de la division Cloud + Enterprise.
Février est terminé et il est temps de présenter un autre épisode des notes de publication sur docs.microsoft.com.
Nouvelles publications de documentation
Nous venons juste de publier davantage de contenu qui vous permettra d’en savoir plus sur nos produits et de vous familiariser avec eux !
- La documentation de développement Azure .NET est désormais disponible pour nos utilisateurs en Chine
- Documentation de référence PowerShell Azure Resource Manager 5.3.0
- Guide de Microsoft Message Analyzer
- Documentation Cognitive Services Java
Nous continuons de travailler sur la migration du contenu de MSDN vers docs.microsoft.com : nous allons non seulement nous assurer que le contenu est correctement déplacé, mais aussi que les liens pointent vers le nouveau contenu sur docs.microsoft.com automatiquement ; si vous détectez des liens rompus, signalez-les.
Nouveaux outils et fonctionnalités
La plupart des fonctionnalités que nous avons générées au cours du mois passé étaient en arrière-plan : nous améliorons la stabilité et la résilience de nos services tout en créant également des pipelines de publication pour différentes parties du contenu. Ceci dit, il y a bien eu deux ajouts majeurs, indiqués ci-dessous.
Explorateur d’API Python
L’un des points clés de la documentation des API est de faire en sorte qu’elle soit complète et facilement découvrable. Comme nous avons constaté que l’Explorateur d’API .NET et l’Explorateur de modules PowerShell obtenaient un franc succès auprès de la communauté, nous avons voulu faciliter la recherche des API Python fournies par Microsoft à la fois pour les développeurs débutants et chevronnés.
Nous avons récemment annoncé la publication de l’Explorateur d’API Python, le meilleur moyen de rechercher les API Python fournies par Microsoft. Que vous utilisiez le kit SDK Azure pour Python ou Cognitive Toolkit, vous pouvez rapidement trouver les API appropriées en accédant à docs.microsoft.com/python/api.
À mesure que le nombre d’API Python fournies augmente, nous continuerons la mise à jour de l’Explorateur d’API Python avec les nouvelles versions.
Commentaires sur le site sur GitHub
Nous continuons de déployer tous nos efforts en matière d’ouverture et de transparence dans notre documentation : il est très appréciable que notre communauté soit habilitée à fournir des commentaires détaillés sur la façon d’améliorer les diverses utilisations de la documentation. Dans le cadre de ce processus, nous avons transféré notre système de commentaires pour reposer entièrement sur GitHub Issues. La seule partie qui se trouvait en dehors de GitHub était les commentaires sur le site.
Avant, nous hébergions tous les commentaires sur le site docs.microsoft.com sur UserVoice et, même si cela semblait être alors une bonne solution, en nous engageant davantage vers une documentation hébergée sur GitHub, nous voulions réduire les frictions pour les utilisateurs quand il s’agit de fournir des commentaires au même endroit où se tient déjà la conversation autour de notre contenu ; par conséquent, la décision suivante a été simple : déplacer tous nos commentaires sur le site sur GitHub.
Nous effectuons un tri des problèmes tous les jours ; par conséquent, une fois que vous envoyez votre idée, il est probable que vous aurez très vite de nos nouvelles, et des étiquettes vous permettront de connaître l’état exact de la demande. De plus, étant donné la puissance de l’interface utilisateur de GitHub Issues, vous pouvez maintenant voir le responsable de programme qui sera chargé du suivi :
Quand nous avons effectué la transition, nous avons veillé à prendre tous les problèmes ouverts sur UserVoice et à les migrer vers GitHub ; par conséquent, si vous aviez déjà envoyé des idées, celles-ci ne sont pas perdues !
Notes de bas de page
D’autres nouveautés sont prévues pour cette année et nous sommes impatients de vous les faire découvrir !
En attendant, suivez notre blog et notre compte Twitter pour connaître les dernières mises à jour. Si vous avez des fonctionnalités ou des idées à nous soumettre, n’oubliez pas d’ouvrir un nouveau ticket sur GitHub.
Vous rêvez d’un monde meilleur pour les développeurs ? Rejoignez notre équipe !