Note sulla versione - Febbraio 2018

Questo post è stato scritto da Dan Fernandez, Senior Director di Cloud + Enterprise Division.

Febbraio si è concluso ed è arrivato il momento di un nuovo aggiornamento delle note sulla versione di docs.microsoft.com.

Nuova documentazione

Sono appena stati rilasciati nuovi contenuti utili per ottenere informazioni sui prodotti Microsoft.

• La documentazione per gli sviluppatori .NET Azure ora è disponibile per gli utenti in Cina
• Documentazione di riferimento su PowerShell per Azure Resource Manager 5.3.0
• Guida di Microsoft Message Analyzer
• Documentazione Java sui Servizi cognitivi

Stiamo continuando a lavorare sulla migrazione del contenuto da MSDN a docs.microsoft.com: verificheremo non solo che il contenuto sia stato trasferito correttamente, ma anche che i collegamenti puntino automaticamente al nuovo contenuto su docs.microsoft.com. Se si rilevano eventuali collegamenti interrotti, è possibile segnalarli.

Nuovi strumenti e funzionalità

Molte delle funzionalità di cui ci siamo occupati nell'ultimo mese operano dietro le quinte: stiamo migliorando la stabilità e la resilienza dei servizi Microsoft, oltre a creare nuove pipeline di pubblicazione per diverse parti del contenuto. Ciò premesso, sono stati aggiunti due importanti elementi, illustrati di seguito.

Browser per le API Python

Uno degli aspetti chiave per la documentazione sulle API consiste nel renderla completa e facilmente individuabile. Avendo notato il grande successo riscosso nella community dal Browser API .NET e dal browser per moduli PowerShell, abbiamo deciso di rendere più semplice trovare le API Python fornite da Microsoft per gli sviluppatori con qualsiasi livello di esperienza.

Di recente, abbiamo annunciato il rilascio del browser per le API Python, la soluzione migliore per trovare le API Python fornite da Microsoft. Che si lavori con Azure Python SDK o Cognitive Toolkit, è possibile individuare rapidamente le API appropriate visitando docs.microsoft.com/python/api.

Con l'aumento del numero di API Python rese disponibili da Microsoft, continueremo ad aggiornare il browser per le API Python con nuove versioni.

Commenti per il sito in GitHub

Continuiamo a portare avanti le nostre iniziative incentrate sull'apertura e la trasparenza nella documentazione: vogliamo che i membri della community possano fornire commenti e suggerimenti dettagliati su come migliorare le esperienze relative alla documentazione. Nell'ambito di queste attività, abbiamo aggiornato il sistema per i commenti in modo da fare completamente uso dei problemi di GitHub. L'unico elemento che non rientrava in GitHub erano i commenti e i suggerimenti per il sito.

In precedenza, tutti i commenti e i suggerimenti per il sito docs.microsoft.com erano ospitati in UserVoice. Se questa inizialmente rappresentava una soluzione valida, con l'aumento del numero di documenti basati su GitHub, abbiamo pensato di facilitare le attività per gli utenti, consentendo loro di inviare commenti e i suggerimenti dalla stessa posizione in cui ha luogo la discussione sul contenuto. La decisione successiva è stata semplice: spostare tutti i commenti e i suggerimenti per il sito in GitHub.

Poiché eseguiamo la valutazione dei problemi ogni giorno, dopo aver inviato un'idea, in genere si riceve una risposta in breve tempo. Inoltre, le etichette consentono di conoscere con precisione lo stato della richiesta. Soprattutto, grazie alla potenza dell'interfaccia utente per i problemi di GitHub, ora è possibile visualizzare il Program Manager responsabile per il completamento:

Nel corso della transizione, ci siamo assicurati di eseguire la migrazione di tutti i problemi da UserVoice in GitHub, pertanto le idee e i suggerimenti inviati in precedenza non sono andati persi.

Note a piè di pagina

Ci sono molte altre novità in programma per quest'anno e siamo ansiosi di presentarle.

Nel frattempo, per restare al corrente con gli ultimi aggiornamenti, seguire il blog e l'account Twitter. Per inviare idee o suggerimenti sulle funzionalità, è possibile aprire un nuovo problema in GitHub.

Si vuole contribuire a semplificare le attività per gli sviluppatori? È possibile entrare a far parte del nostro team!