Microsoft 開発者向けの Stack Overflow ドキュメント

この投稿は、クラウド + エンタープライズ部門の Jeff Sandquist、 General Manager によって書かれています。

本日、Microsoft 開発者向けの Stack Overflow ドキュメントをサポートするために、Stack Overflow とのパートナーシップを発表します。 この発表の一環として、Stack Overflow ドキュメントのコンテンツは、今後 docs.microsoft.com API リファレンス コンテンツに統合される予定です。 Microsoft は長い間、スポンサー付きタグの形式で Stack Overflow のパートナーであり、Stack Overflow ドキュメントの立ち上げにより、.NET Framework、Xamarin、およびその他の Microsoft 製品やテクノロジを使用してコード サンプルを簡単に作成して投票できます。

共有の目標

docs.microsoft.com と Stack Overflow の両方に共通の目標がありました。製品やサービスを使用するための優れたドキュメントをコミュニティが簡単かつ簡単に投稿できるようにしたいと考えています。 どちらのコンテンツ セットにもオープン ライセンスがあり、コンテンツ形式として markdown を使用し、コミュニティへの投稿を簡単に有効にします (任意の docs.microsoft.com ページから [編集] をクリックします)。

.NET 開発者向けの Stack Overflow のクイック ツアー

StackOverflow ドキュメントに初めて到着すると、使い慣れたタグベースのトピックの分類が利用可能になります。 一見すると、StackOverflow コミュニティによって以前に作成されたすべてのタグが表示されます。 タグでフィルター処理すると、それぞれの一覧が表示され、いくつかの重要なメトリック (トピック要求の数、提案された変更、改善要求) がすぐに表示されます。

トピックを要求する

StackOverflow の対象ユーザーの助けを借りずに困難な問題を解決した開発者はほとんどいない。 StackOverflow で自社製品に関連する質問を監視するコミュニティの同僚、同僚、伝説と共に、タグ別に整理された情報ネットワークを構築しました。 ドキュメントでは、サポートを求める場所を提供することで、知識を集合的に構築するという視聴者のコミットメントを活用しています。各タグの 「要求されたトピック」セクションは、コミュニティに共通の問題を特定する場所を提供します。

[トピックの作成] をクリックすると、トピックのコンテンツを作成し、独自のコード サンプルとドキュメントを提供できます。 このエクスペリエンスでは、コンテンツの各セクションを提供する場所に関するガイダンスを提供します。必要に応じて Markdown 構文を使用して編集できます。 トピックを作成すると、進行状況が適切なナビゲーションに保存され、まだ完了していない、またはレビュー用に送信したすべての下書きコンテンツを確認できます。

使い慣れたコード表示エクスペリエンス

StackOverflow Q&A サイトと同様に、個々のトピックのコードは明確で簡潔な形式で表示されるため、コードをコピーして編集して使用したり、コードを読むだけで学習したりできます。 開発者は、Stack Overflow の回答と同様に、投票コード サンプルをアップ/ダウンできます。

将来の統合

今後、docs.microsoft.com は、Stack Overflow ドキュメント サンプルのキュレーションされた一覧を Microsoft API ドキュメントに直接統合する予定です。 Microsoft API リファレンスを参照している開発者には、Microsoft によって作成されたサンプルと、コミュニティによって作成された Stack Overflow のサンプルの両方が表示されます。 サンプルは、コード サンプルが確立された .NET コーディング ガイドラインとベスト プラクティスを使用するようにキュレーションされます。 この統合の詳細については、今後リリースする予定です。