Documentazione di Stack Overflow per gli sviluppatori Microsoft

Questo articolo è stato scritto da Jeff Sandquist, General Manager di Cloud + Enterprise Division.

Oggi annunciamo una partnership con Stack Overflow per supportare la documentazione di Stack Overflow per gli sviluppatori Microsoft. Nell'ambito di questo annuncio, microsoft annuncia che Stack Overflow contenuto della documentazione verrà integrato nel docs.microsoft.com di riferimento dell'API in futuro. Microsoft è da tempo partner di Stack Overflow sotto forma di tag sponsor e il lancio della documentazione di Stack Overflow consente alla community di avere un modo semplice per creare e votare esempi di codice usando .NET Framework, Xamarin e altri prodotti e tecnologie Microsoft.

Obiettivi condivisi

Sia docs.microsoft.com che Stack Overflow hanno obiettivi condivisi: si vuole rendere più semplice e semplice per la community contribuire a una documentazione di grande qualità per l'uso di prodotti e servizi. Entrambi i set di contenuti hanno una licenza aperta, usano markdown come formato del contenuto e abilitano facilmente i contributi della community (fare clic su Modifica da qualsiasi docs.microsoft.com pagina).

Breve panoramica dei Stack Overflow per sviluppatori .NET

Quando si arriva per la prima volta alla documentazione di StackOverflow, è possibile trovare la già nota categorizzazione basata su tag degli argomenti disponibili. A prima vista verranno visualizzati tutti i tag creati in precedenza dalla community di StackOverflow. Dopo aver applicato un filtro in base al tag, viene visualizzato un elenco di ognuna con alcune metriche importanti visualizzate in anticipo: il numero di richieste di argomento, le modifiche proposte e le richieste di miglioramento.

Ricerca di contenuto tramite tag

Richiedere un argomento

Pochi sviluppatori hanno risolto problemi complessi senza l'aiuto dei destinatari di StackOverflow. Insieme ai colleghi, ai colleghi e alle legende della community che monitorano StackOverflow per le domande relative ai propri prodotti, è stata creata una rete di informazioni organizzate in base ai tag. La documentazione capitalizza l'impegno del pubblico a creare collettivamente conoscenze offrendo un posto in cui chiedere assistenza. La sezione "Argomenti richiesti" di ogni tag offre alla community un luogo in cui identificare i problemi comuni.

Argomenti richiesti

Facendo clic su "Crea argomento", è possibile creare contenuto per l'argomento e fornire esempi di codice e documentazione personalizzati. L'esperienza fornisce indicazioni su dove fornire ogni sezione del contenuto, che può essere modificata usando la sintassi Markdown, se si preferisce. Quando si creano argomenti, lo stato di avanzamento viene salvato nel riquadro di spostamento a destra, in cui è possibile visualizzare tutto il contenuto della bozza non ancora completato o inviato per la revisione.

Creazione di un nuovo argomento

Esperienza di visualizzazione del codice familiare

Come per il sito di Domande e risposte di StackOverflow, il codice per i singoli argomenti viene presentato in un formato chiaro e conciso per poter copiare, modificare e usare o apprendere semplicemente leggendo il & codice. Gli sviluppatori possono votare o votare gli esempi di codice esattamente come le risposte Stack Overflow.

Argomento esistente

Integrazione futura

In futuro, docs.microsoft.com un elenco curato di esempi Stack Overflow documentazione direttamente nella documentazione delle API Microsoft. Gli sviluppatori che esaminano le informazioni di riferimento sulle API Microsoft visualizzano sia gli esempi creati da Microsoft che gli Stack Overflow della community. Gli esempi verranno curati per assicurarsi che gli esempi di codice usino procedure consigliate e linee guida per la scrittura di codice .NET stabilite. In futuro verranno rilasciati altri dettagli su questa integrazione.