Annuncio di docs.microsoft.com/samples

Questo post è stato scritto da Den Delimarsky, Senior Program Manager, Cloud e intelligenza artificiale.

Oggi siamo lieti di annunciare una nuova esperienza in docs.microsoft.com: una nuova area per esplorare tutti gli esempi di codice di Microsoft disponibile in docs.microsoft.com/samples. Con questa versione, Microsoft mira a semplificare l'individuazione degli esempi di codice pertinenti per iniziare, indipendentemente dal prodotto o servizio Microsoft in uso.

Samples browser on docs.microsoft.com

A partire da oggi, docs.microsoft.com/samples è l'area in cui trovare gli esempi di codice più aggiornati rilevanti per tutti i flussi di lavoro. Microsoft si è assicurata di potenziare gli strumenti disponibili per il contenuto ospitato e la ricerca di codice ospitato su GitHub. È possibile offrire il proprio contributo per qualsiasi esempio indicizzato, aprendo una richiesta di pull nel repository. Se si riscontra un bug in un esempio durante l'esecuzione, è possibile aprire un problema nel repository in cui si trova l'esempio, in modo che il team che gestisce il codice possa occuparsene.

Il nuovo sito offre anche un'ampia gamma di vantaggi, descritti di seguito, rendendo più semplice che mai intraprendere progetti di sviluppo.

Distribuzione in Azure con un solo clic

Sono ospitati più esempi a cui sono associati modelli di Azure Resource Manager (ARM) predefiniti. È ora possibile distribuire questi esempi direttamente in Azure dalla pagina in docs.microsoft.com con un solo clic.

One-click deployment of a code sample to Azure

Scaricare solo ciò che serve

Sarà sicuramente capitato molte volte di voler esaminare un solo esempio da un repository che ne contiene decine e di trovarsi costretti a clonare tutto il contenuto per poter lavorare solo a tale singolo progetto. Con docs.microsoft.com/samples è ora possibile scaricare il codice di interesse senza dover clonare l'intero repository. La funzionalità Download ZIP (Scarica ZIP) consente di ottenere immediatamente la versione più recente dell'esempio specifico da GitHub.

Button that shows how to download a ZIP for a sample

Sono disponibili molti repository, spesso con esempi annidati a diversi livelli di profondità. Non è più necessario dedicare tempo a capire dove si trova l'esempio di codice nel repository se si vuole esaminare più in dettaglio l'implementazione. È sufficiente fare clic Browse code (Esplora codice) per accedere immediatamente alla posizione all'interno dell'origine GitHub.

Navigate directly to the code sample from the sample page

Risultati della ricerca e filtro dei risultati immediati

Per la ricerca di un esempio è ora possibile usare sia la ricerca di parole chiave sia i filtri nella pagina: il tutto all'interno di un'unica visualizzazione con i risultati che vengono aggiornati immediatamente in base alle selezioni.

Filtering and searching code samples

Conclusioni

Microsoft è lieta di offrire un'esperienza migliore per gli esempi di codice e provvederà a migliorare in modo continuativo il sito docs.microsoft.com/samples in base ai commenti e ai suggerimenti degli sviluppatori sulle loro esperienze con ambienti specifici. Verranno anche aggiunti in modo continuativo ulteriori esempi all'indice, quindi invitiamo i clienti a segnalare eventuale codice Microsoft ufficiale non ancora individuabile.

Tutte le novità saranno segnalate con annunci futuri.

I commenti e suggerimenti degli utenti sono molto apprezzati

Durante l'implementazione del nuovo visualizzatore per gli esempi, i commenti e i suggerimenti degli utenti per eventuali miglioramenti sono fondamentali. È possibile contattare Microsoft su Twitter o tramite il repository ufficiale per i commenti e i suggerimenti di docs.microsoft.com.