Documentation Stack Overflow pour les développeurs Microsoft

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

Nous lançons aujourd’hui un partenariat avec Stack Overflow afin de prendre en charge la documentation Stack Overflow pour les développeurs Microsoft. Dans le cadre de cette annonce, nous informons nos utilisateurs que le contenu de la documentation Stack Overflow sera à l’avenir intégré au contenu de référence des API sur docs.microsoft.com. Microsoft est depuis longtemps partenaire de Stack Overflow sous la forme d’étiquettes sponsorisées, et le lancement de Stack Overflow Documentation donne à la communauté un moyen simple de créer et d’évaluer des exemples de code en utilisant le .NET Framework, Xamarin et d’autres produits et technologies Microsoft.

Objectifs partagés

Stack Overflow et docs.microsoft.com ont un objectif commun qui est de permettre à la communauté de contribuer facilement à la documentation sur l’utilisation de produits et de services. Les deux ensembles de contenu ont une licence ouverte, utilisent Markdown comme format de contenu et facilitent les contributions de la communauté au contenu (en cliquant sur Modifier à partir de n’importe quelle page docs.microsoft.com).

Présentation rapide de Stack Overflow pour les développeurs .NET

Quand vous arrivez pour la première fois sur Stack Overflow Documentation, vous pouvez constater une catégorisation familière des rubriques disponibles au moyen d’étiquettes. En un coup d’œil, vous pouvez voir toutes les étiquettes créées précédemment par la communauté Stack Overflow. Quand vous filtrez par étiquette, une liste apparaît avec quelques métriques importantes : nombre de demandes de rubrique, modifications proposées et demandes d’amélioration.

Demander une rubrique

Peu de développeurs peuvent se passer de la communauté Stack Overflow pour résoudre des problèmes difficiles. En collaboration avec nos collègues, pairs et légendes de la communauté qui traitent des questions en rapport avec leurs propres produits sur Stack Overflow, nous avons construit un réseau d’informations organisées par étiquettes. Documentation capitalise sur l’engagement de la communauté à construire collectivement des connaissances en nous donnant un endroit pour demander de l’aide. Ainsi, la section « Rubriques demandées » de chaque étiquette donne à la communauté un endroit pour identifier les problèmes communs.

En cliquant sur « Créer une rubrique », vous pouvez créer du contenu pour la rubrique et fournir vos propres exemples de code et de la documentation. L’expérience donne des conseils sur l’emplacement de chaque section de contenu, que vous pouvez modifier à l’aide de la syntaxe Markdown si vous préférez. À mesure que vous créez des rubriques, votre progression est enregistrée dans la navigation de droite où vous pouvez voir tous les brouillons de contenu que vous n’avez pas encore terminés ou envoyés pour révision.

Expérience de visualisation de code familière

Comme dans le site Q&A de Stack Overflow, le code pour les rubriques individuelles est présenté dans un format clair et concis, ce qui vous permet de copier-modifier-utiliser ou de lire simplement le code. Les développeurs peuvent évaluer vos exemples de code, tout comme les réponses sur Stack Overflow.

Intégration future

À l’avenir, docs.microsoft.com intégrera une liste organisée d’exemples de documentation Stack Overflow directement dans la documentation sur les API Microsoft. Les développeurs qui consultent les informations de référence sur les API Microsoft verront à la fois les exemples créés par Microsoft et les exemples de Stack Overflow créés par la communauté. Les exemples de code seront curés afin de garantir qu’ils respectent les directives et bonnes pratiques en matière de programmation .NET. Nous publierons plus de détails sur cette intégration ultérieurement.