Documentation Xamarin maintenant disponible sur docs.microsoft.com

Cet article a été écrit par Craig Dunn, responsable de programmes senior chez Xamarin.

Notes

Cette annonce est une publication croisée à partir du blog Xamarin.

Nous entamons aujourd’hui un nouveau chapitre de la documentation pour développeur d’applications mobiles : la documentation Xamarin est désormais en ligne sur docs.microsoft.com/xamarin ! Voici quelques points clés de la nouvelle expérience de documentation :

Hub de documentation Xamarin

Il suffit d’un ou de deux clics dans la page docs.microsoft.com/xamarin pour afficher toutes les options de notre documentation. Cliquez sur Xamarin dans l’en-tête pour revenir ici à partir de n’importe quelle page. Utilisez les liens de la plateforme pour voir notre documentation du développeur mobile et basculez vers les onglets Graphisme et jeux ou Outils pour en savoir plus sur les rubriques connexes telles que SkiaSharp, Xamarin Workbooks et Xamarin Live Player.

Hub Xamarin sur docs.microsoft.com

Nouvelle navigation

docs.microsoft.com offre de nouvelles options de navigation dans la documentation Xamarin :

Page de documentation Xamarin sur docs.microsoft.com

  1. Pages d’accueil de plateforme : vue d’ensemble et référence rapide pour la documentation disponible sur chaque plateforme. Utilisez les liens dans la barre d’en-tête bleue pour accéder à chaque page de plateforme : Android, iOS, Mac et Xamarin.Forms.
  2. Rechercher : cliquez sur la loupe à droite de l’en-tête pour effectuer des recherches dans le contenu Xamarin.
  3. Vues miniatures : placées sous l’en-tête, les vues miniatures vous aident à vous repérer dans la documentation associée.
  4. Arborescence de navigation : descendez rapidement dans la hiérarchie à l’aide de l’arborescence.
  5. Filtre de navigation : filtrez l’arborescence de navigation pour rechercher un titre de rubrique.
  6. Dans cet article : une table des matières est générée pour chaque article, avec un indicateur pratique pour l’emplacement de défilement dans le document.
  7. Zoom sur une image : vous pouvez cliquer sur les images avec une icône en forme de loupe dans l’angle inférieur droit pour afficher plus de détails.

Vidéo

Des présentations et des leçons dirigées par des spécialistes et Xamarin University sont maintenant disponibles en ligne, comme cette rubrique Dispositions Xamarin.Forms :

Vidéo intégrée à une page de documentation docs.microsoft.com

Open source

Chaque page contient un lien Modifier afin que la communauté puisse contribuer aux correctifs et mises à jour. Les commentaires sur la documentation deviennent des problèmes GitHub afin de suivre leur progression. Pour obtenir des instructions sur l’envoi de modifications, lisez la Marche à suivre pour contribuer.

Dans votre langue

À l’aide d’une combinaison de techniques de traduction, la documentation du développeur Xamarin est désormais disponible en 13 langues en plus de l’anglais : Chinois (simplifié), Chinois (traditionnel), Tchèque, Français, Italien, Coréen, Allemand, Japonais, Polonais, Portugais (Brésil), Russe, Espagnol et Turc. Visitez le blog de la documentation pour plus d’informations sur les fonctionnalités internationales.

Editor Switcher (Sélecteur d’éditeur)

Parfois, vous avez besoin d’instructions spécifiques à votre éditeur de code : Visual Studio 2017 ou Visual Studio pour Mac. Ceux-ci se trouvent désormais dans des onglets au sein de chaque page :

Onglets de contenu conceptuel sur docs.microsoft.com

Beau code

Les extraits de code font l’objet d’une coloration syntaxique et un bouton Copier permet de récupérer aisément des extraits pour vos applications :

Extraits de code sur docs.microsoft.com

Explorateur d’API

La documentation sur les API BCL Xamarin est déjà disponible dans l’Explorateur d’API .NET et nos API spécifiques à une plateforme seront bientôt disponibles.

Présentation interactive

Que vous lisiez sur votre téléphone, tablette ou poste de travail, le site docs.microsoft.com s’adapte afin de garantir un contenu clair et facile à lire, tout en gardant une navigation accessible :

Présentation interactive sur docs.microsoft.com

Thème foncé

Il existe même une option pour lire la documentation avec un thème sombre !

Thème sombre sur docs.microsoft.com

Et maintenant ?

Vous remarquerez qu’une partie du contenu est toujours hébergée sur notre ancien site, notamment la documentation sur les API, les classeurs et les exemples. L’équipe travaille sans relâche pour migrer ces éléments afin de créer une expérience unique.

C’est le cœur lourd que nous disons adieu à notre ancien site sur developer.xamarin.com, mais je suis très heureux de vous présenter les nouvelles fonctionnalités disponibles sur docs.microsoft.com/xamarin et très impatient de créer une expérience de documentation encore meilleure et encore plus complète pour les développeurs Xamarin. Donnez-nous votre avis dans les forums.

P.-S. : Si vous avez marqué d’un signet les liens vers l’ancien site des développeurs ou créé un blog pour ceux-ci, ne vous inquiétez pas. Ils seront automatiquement redirigés vers la page équivalente sur le nouveau site !