Documentazione di Xamarin ora disponibile su docs.microsoft.com
Questo post è stato scritto da Craig Dunn, Principal Program Manager in Xamarin.
Nota
Questo annuncio è un riferimento incrociato a un post dal blog di Xamarin.
Oggi stiamo iniziando un nuovo capitolo nella documentazione per sviluppatori per dispositivi mobili: la documentazione di Xamarin è ora disponibile in docs.microsoft.com/xamarin. Ecco alcune delle principali caratteristiche della nuova esperienza per la documentazione:
Tutte le opzioni per la documentazione sono accessibili con al massimo un paio di clic da docs.microsoft.com/xamarin. Fare clic su Xamarin nell'intestazione per tornare qui da qualsiasi pagina. Usare i collegamenti della piattaforma per visualizzare la documentazione per sviluppatori per dispositivi mobili e passare alle schede Grafica e giochi o Strumenti per altre informazioni su argomenti correlati, come SkiaSharp, Workbooks e Xamarin Live Player.
docs.microsoft.com offre alcune nuove opzioni per gli spostamenti all'interno della documentazione di Xamarin:
- Home page per le piattaforme: panoramica e informazioni di riferimento rapide per la documentazione disponibile per ogni piattaforma. Usare i collegamenti nella barra d'intestazione blu per visitare la pagina per ogni piattaforma: Android, iOS, Mac e Xamarin.Forms.
- Ricerca: fare clic sulla lente di ingrandimento a destra dell'intestazione per eseguire ricerche nel contenuto di Xamarin.
- Percorso di navigazione: subito sotto l'intestazione, il percorso di navigazione consente di spostarsi agevolmente tra documenti correlati.
- Albero di spostamento: eseguire velocemente il drill-down usando la visualizzazione ad albero.
- Filtro di spostamento: filtrare l'albero di spostamento per trovare il titolo di un argomento.
- Contenuto dell'articolo: per ogni articolo viene generato un sommario, incluso un comodo indicatore della posizione all'interno del documento.
- Zoom delle immagini: è possibile fare clic sulle immagini con l'icona di una lente di ingrandimento nell'angolo in basso a destra per visualizzare maggiori dettagli.
Sono ora disponibili in linea presentazioni e lezioni da evangelist e Xamarin University, come in questo argomento Xamarin.Forms Layouts (Layout di Xamarin.Forms):
Ogni pagina contiene un collegamento Modifica in modo che la community possa contribuire con correzioni e aggiornamenti. I commenti per la documentazione diventano problemi di GitHub in modo da poter tener traccia dello stato dei commenti inviati. Leggere le linee guida per i contributi per istruzioni sull'invio di modifiche.
Usando varie combinazioni di tecniche di traduzione, la documentazione per sviluppatori Xamarin è ora disponibile in 13 lingue oltre all'inglese: ceco, cinese semplificato, cinese tradizionale, coreano, francese, giapponese, italiano, polacco, portoghese (Brasile), russo, spagnolo, tedesco e turco. Visitare il blog di docs per altre informazioni sulle funzionalità internazionali.
In alcuni casi sono necessarie istruzioni specifiche per l'editor del codice in uso: Visual Studio 2017 o Visual Studio per Mac. Queste istruzioni sono ora disponibili in schede all'interno di ogni pagina:
I frammenti di codice sono evidenziati con la sintassi ed è disponibile un pulsante Copia che semplifica l'afferramento dei frammenti di codice per le app:
La documentazione relativa alle API della libreria di classi base di Xamarin è già disponibile nel browser per le API .NET e le API specifiche della piattaforma Microsoft saranno presto disponibili.
Sia che si stia leggendo sul telefono, sul tablet o sul desktop, il sito docs.microsoft.com ridimensiona per garantire che il contenuto sia chiaro e facile da leggere, mantenendo lo spostamento accessibile:
C'è anche un'opzione per leggere la documentazione con un tema scuro!
Si noterà che alcuni contenuti sono ancora ospitati nel sito precedente, tra cui documentazione api, cartelle di lavoro ed esempi. Il team sta lavorando alacremente per eseguire la migrazione di questi contenuti e creare un'esperienza unificata.
È con un cuore pesante che diciamo addio al nostro vecchio sito a developer.xamarin.com, tuttavia sono entusiasta delle nuove funzionalità disponibili in docs.microsoft.com/xamarin e non vedo l'ora di creare un'esperienza di documentazione ancora più grande e migliore per gli sviluppatori Xamarin. Fateci sapere cosa ne pensate nei forum.
P.S.: Se sono stati inseriti i segnalibri o i collegamenti registrati al vecchio sito per sviluppatori, non preoccuparti: verranno reindirizzati automaticamente alla pagina equivalente nel nuovo sito.