Documentación de Xamarin ahora disponible en docs.microsoft.com

El autor de este artículo es Craig Dunn, jefe principal de programas de Xamarin.

Nota:

Este anuncio es una entrada transversal en el blog de Xamarin.

Hoy comenzamos un nuevo capítulo en la documentación para desarrolladores de móviles: los documentos de Xamarin están ahora en directo en docs.microsoft.com/xamarin. Estos son algunos aspectos destacados de la nueva experiencia de documentación:

Xamarin Docs Hub

Todas nuestras opciones de documentación se encuentran a un clic o dos de distancia de docs.microsoft.com/xamarin. Haga clic en Xamarin en el encabezado para volver aquí desde cualquier página. Use los vínculos de la plataforma para ver nuestros documentos para desarrolladores de móviles y cambie a las pestañas Juegos y gráficos o Herramientas para obtener más información sobre temas relacionados tales como SkiaSharp, Workbooks y Xamarin Live Player.

Centro de Xamarin en docs.microsoft.com

Nueva navegación

docs.Microsoft.com ofrece algunas opciones nuevas para navegar por la documentación de Xamarin:

Página de documentación de Xamarin en docs.microsoft.com

  1. Páginas principales de plataforma: información general y referencia rápida de los documentos disponibles en cada plataforma. Use los vínculos de la barra de encabezado azul para visitar la página de cada plataforma: Android, iOS, Mac y Xamarin.Forms.
  2. Búsqueda: haga clic en la lupa a la derecha del encabezado para buscar contenido de Xamarin.
  3. Rutas de navegación: escondidas bajo el encabezado, las rutas de navegación ayudan a encontrar documentos relacionados.
  4. Árbol de navegación: explore en profundidad rápidamente con la vista de árbol.
  5. Filtro de navegación: filtre el árbol de navegación para buscar un título de tema.
  6. En este artículo: cada artículo tiene una tabla de contenido generada, incluido un indicador práctico de la ubicación de desplazamiento en el documento.
  7. Zoom de imágenes: imágenes con un icono de lupa en la esquina inferior derecha en donde se puede hacer clic para mostrar más detalles.

Vídeo

Ahora hay presentaciones y lecciones de expertos y de Xamarin University disponibles en línea, como este tema, Diseños de Xamarin.Forms:

Vídeo integrado en una página de documentación de docs.microsoft.com

Código abierto

Cada página contiene un vínculo Editar para que la comunidad pueda contribuir con correcciones y actualizaciones. Los comentarios realizados en los documentos se convierten en problemas de GitHub para que pueda realizar el seguimiento del progreso de sus comentarios de documentos. Lea las directrices de contribución para obtener instrucciones sobre cómo enviar los cambios.

En su idioma

Mediante una combinación de técnicas de traducción, la documentación para desarrolladores de Xamarin ahora está ahora disponible en 13 idiomas además del inglés: chino (simplificado), chino (tradicional), checo, francés, italiano, coreano, alemán, japonés, polaco, portugués (Brasil), ruso, español y turco. Visite el blog de documentos para obtener más información sobre las características internacionales.

Selector de editor

En ocasiones necesitará instrucciones específicas del editor de código: Visual Studio 2017 o Visual Studio para Mac. Estos se encuentran ahora en pestañas dentro de cada página:

Pestañas de contenido conceptual en docs.microsoft.com

Código atractivo

Los fragmentos de código se resaltan en la sintaxis y hay un botón Copiar que facilita la captura de fragmentos de código para las aplicaciones:

Fragmentos de código en docs.microsoft.com

Explorador de API

Los documentos de la API de BCL de Xamarin ya están disponibles en el Explorador de API de .NET y pronto se incorporarán nuestras API específicas de la plataforma.

Diseño dinámico

Tanto si lo lee en el teléfono, la tableta o en el escritorio, el sitio docs.microsoft.com se escala para garantizar que el contenido resulte claro y legible, al tiempo que la navegación sigue siendo accesible:

Diseño dinámico en docs.microsoft.com

Tema oscuro

Hay incluso una opción para leer los documentos con un tema oscuro.

Tema oscuro en docs.microsoft.com

Pasos siguientes

Observará que algún contenido sigue hospedado en nuestro sitio anterior, lo que incluye documentos de API, Workbooks y ejemplos. El equipo se esfuerza en migrar estos elementos para crear una experiencia unificada.

Nos despedimos de nuestro sitio anterior en developer.xamarin.com con gran pesadumbre, pero estoy entusiasmado con las nuevas características disponibles en docs.microsoft.com/xamarin y espero que se cree una experiencia de documentación mejor e incluso mayor para los desarrolladores de Xamarin. Dénos su opinión en los foros.

P.D.: Si ha marcado el sitio anterior como favorito o ha incluido en el blog vínculos al sitio anterior para desarrolladores, no se preocupe: se le redirigirá automáticamente a la página equivalente en el nuevo sitio.