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.

Visualizzatore degli esempi in 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.

Distribuzione con un clic di un esempio di codice in 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.

Pulsante che mostra come scaricare un file ZIP per un esempio

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.

Passare direttamente all'esempio di codice dalla pagina dell'esempio

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.

Filtrare e cercare esempi di codice

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.