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 iniziamo un nuovo capitolo della 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 alla piattaforma per visualizzare la documentazione per sviluppatori per dispositivi mobili e passare alle schede Giochi & grafici o Strumenti per altre informazioni sugli argomenti correlati, ad esempio SkiaSharp, Cartelle di lavoro e Xamarin Live Player.

Xamarin hub on docs.microsoft.com

Nuove opzioni per lo spostamento

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

Xamarin documentation page on 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

Le presentazioni & degli evangelisti e dell'Università Xamarin sono ora disponibili inline, ad esempio questo argomento di layout Xamarin.Forms :

Video integrated in a docs.microsoft.com documentation page

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:

Tabs in conceptual content on docs.microsoft.com

Codice formattato

I frammenti di codice sono evidenziati dalla sintassi e c'è un pulsante Copia che semplifica l'afferramento dei frammenti per le app:

Code snippets on 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, la scalabilità del sito docs.microsoft.com per garantire che il contenuto sia chiaro e facile da leggere, mantenendo la navigazione accessibile:

Responsive design on docs.microsoft.com

Tema scuro

C'è anche un'opzione per leggere i documenti con un tema scuro!

Dark theme on 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 e 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 in developer.xamarin.com, tuttavia sono entusiasta delle nuove funzionalità disponibili in docs.microsoft.com/xamarin e guardare avanti a 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 sito di sviluppo precedente, non preoccuparsi: verranno reindirizzati automaticamente alla pagina equivalente nel nuovo sito!