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:

Hub docs per Xamarin

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.

Hub Xamarin su docs.microsoft.com

Nuove opzioni per lo spostamento

docs.microsoft.com offre alcune nuove opzioni per gli spostamenti all'interno della documentazione di Xamarin:

Pagina della documentazione di Xamarin su docs.microsoft.com

  1. 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.
  2. Ricerca: fare clic sulla lente di ingrandimento a destra dell'intestazione per eseguire ricerche nel contenuto di Xamarin.
  3. Percorso di navigazione: subito sotto l'intestazione, il percorso di navigazione consente di spostarsi agevolmente tra documenti correlati.
  4. Albero di spostamento: eseguire velocemente il drill-down usando la visualizzazione ad albero.
  5. Filtro di spostamento: filtrare l'albero di spostamento per trovare il titolo di un argomento.
  6. Contenuto dell'articolo: per ogni articolo viene generato un sommario, incluso un comodo indicatore della posizione all'interno del documento.
  7. 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.

Video

Sono ora disponibili in linea presentazioni e lezioni da evangelist e Xamarin University, come in questo argomento Xamarin.Forms Layouts (Layout di Xamarin.Forms):

Video integrato in una pagina della documentazione docs.microsoft.com

Open Source

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.

Lingue localizzate

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.

Selezione dell'editor

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:

Schede nel contenuto concettuale in docs.microsoft.com

Codice formattato

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:

Frammenti di codice in docs.microsoft.com

Browser per le API

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.

Progettazione reattiva

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:

Progettazione reattiva su docs.microsoft.com

Tema scuro

C'è anche un'opzione per leggere la documentazione con un tema scuro!

Tema scuro su docs.microsoft.com

in ordine di priorità

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.