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 inizia un nuovo capitolo della documentazione per sviluppatori per dispositivi mobili: la documentazione di Xamarin è ora disponibile su 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

Nei frammenti di codice è evidenziata la sintassi ed è disponibile un pulsante Copia che rende più semplice prelevare frammenti di codice per le proprie 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

Indipendentemente dal fatto che si usi il telefono, il tablet o il desktop per leggere la documentazione, il sito docs.microsoft.com viene ridimensionato in modo automatico per assicurarsi che il contenuto sia chiaro e ben leggibile, mantenendo accessibili gli strumenti di spostamento:

Progettazione reattiva su docs.microsoft.com

Tema scuro

È anche disponibile un'opzione per leggere i documenti con un tema scuro.

Tema scuro su docs.microsoft.com

Passaggi successivi

Si noterà che alcuni contenuti si trovano ancora nel sito precedente, inclusa la documentazione sulle API, le cartelle di lavoro e gli esempi. Il team sta lavorando alacremente per eseguire la migrazione di questi contenuti e creare un'esperienza unificata.

Il sito precedente developer.xamarin.com non è più disponibile, ma le nuove funzionalità in docs.microsoft.com/xamarin sono molto interessanti e permetteranno di creare un'esperienza di documentazione ancora migliore e più estesa per gli sviluppatori Xamarin. Fateci sapere cosa ne pensate nei forum.

P.S. gli utenti che hanno aggiunto segnalibri o pubblicato collegamenti nei blog per contenuti nel vecchio sito per sviluppatori possono stare tranquilli: è attivo il reindirizzamento automatico alla pagina equivalente nel nuovo sito.