Xamarin-documentatie nu op docs.microsoft.com
Dit bericht is geschreven door Craig Dunn, Principal Program Manager bij Xamarin.
Notitie
Deze aankondiging is een cross-post van de Xamarin blog.
Vandaag beginnen we een nieuw hoofdstuk in documentatie voor mobiele ontwikkelaars: Xamarin-documenten zijn nu live op docs.microsoft.com/xamarin! Hier volgen enkele hoogtepunten van de nieuwe documentatie-ervaring:
Al onze documentatieopties zijn een klik of twee verwijderd van docs.microsoft.com/xamarin. Klik op Xamarin- in de koptekst om hier terug te keren vanaf een willekeurige pagina. Gebruik de platformkoppelingen om onze documentatie voor mobiele ontwikkelaars te bekijken en over te schakelen naar de Graphics & Games of Tools tabbladen voor meer informatie over verwante onderwerpen, zoals SkiaSharp, Workbooks en de Xamarin Live Player.
docs.microsoft.com biedt enkele nieuwe opties voor het navigeren in Xamarin-documentatie:
- Platform-startpagina's – Overzicht en beknopt overzicht van de documenten die beschikbaar zijn op elk platform. Gebruik de koppelingen in de blauwe koptekstbalk om elke platformpagina te bezoeken: Android-, iOS-, Mac-en Xamarin.Forms.
- Search – Klik op het vergrootglas rechts van de koptekst om Xamarin-inhoud te zoeken.
- Breadcrumbs – Tucked onder de kop, helpen breadcrumbs u bij het vinden van uw weg naar gerelateerde documenten.
- navigatiestructuur: zoom snel in met behulp van de structuurweergave.
- navigatiefilter: filter de navigatiestructuur om een onderwerpkop te vinden.
- In dit artikel : elk artikel bevat een inhoudsopgave die is gegenereerd, inclusief een handige indicator voor uw schuiflocatie in het document.
- Afbeelding zoomen : afbeeldingen met een vergrootglaspictogram in de rechterbenedenhoek kunnen worden geklikt om meer details weer te geven.
Presentaties & lessen van evangelisten en Xamarin University zijn nu inline beschikbaar, zoals deze Xamarin.Forms Layouts onderwerp:
Elke pagina bevat een koppeling Bewerken, zodat de community oplossingen en updates kan bijdragen. Opmerkingen over de documenten worden GitHub-problemen, zodat u de voortgang van uw feedback over documenten bijhoudt. Lees de richtlijnen voor bijdragen voor instructies over het indienen van wijzigingen.
Met behulp van een combinatie van vertaaltechnieken is Xamarin-documentatie voor ontwikkelaars nu beschikbaar in 13 talen naast Engels: Chinees (vereenvoudigd), Chinees (traditioneel), Tsjechisch, Frans, Italiaans, Koreaans, Duits, Japans, Pools, Portugees (Brazilië), Russisch, Spaans en Turks. Ga naar de docs-blog voor meer informatie over internationale functies.
Soms hebt u instructies nodig die specifiek zijn voor uw code-editor: Visual Studio 2017 of Visual Studio voor Mac. Deze bevinden zich nu op tabbladen op elke pagina:
Codefragmenten zijn syntaxis gemarkeerd en er is een knop Kopiëren waarmee u eenvoudig fragmenten voor uw apps kunt ophalen:
De Xamarin BCL API-documenten zijn al beschikbaar in de .NET API Browseren onze platformspecifieke API's zijn binnenkort beschikbaar.
Of u nu op uw telefoon, tablet of desktop leest, de docs.microsoft.com site wordt geschaald om ervoor te zorgen dat de inhoud duidelijk en gemakkelijk te lezen is, terwijl de navigatie toegankelijk blijft:
Er is zelfs een optie om de documenten te lezen met een donker thema.
U ziet dat bepaalde inhoud nog steeds wordt gehost op onze oude site, waaronder API-documenten, werkmappen en voorbeelden. Het team werkt er hard aan om deze te migreren om een uniforme ervaring te creëren.
Het is met een zwaar hart dat we afscheid nemen van onze oude site op developer.xamarin.com, maar ik ben enthousiast over de nieuwe functies die beschikbaar zijn op docs.microsoft.com/xamarin en kijk uit naar het bouwen van een nog grotere, betere documentatie-ervaring voor Xamarin-ontwikkelaars. Laat ons weten wat u denkt in de forums.
P.S.: Als u koppelingen naar een bladwijzer hebt gemaakt of opgeslagen naar de oude ontwikkelaarssite, hoeft u zich geen zorgen te maken: ze worden automatisch omgeleid naar de equivalente pagina op de nieuwe site.