A Xamarin dokumentációja már elérhető a docs.microsoft.com webhelyen
Ezt a bejegyzést Craig Dunn, a Xamarin fő programmenedzsere írta.
Megjegyzés
Ez a közleményt a Xamarin blogjáról vettük át.
Ma egy új fejezetet kezdünk a mobilfejlesztői dokumentációban – A Xamarin-dokumentumok mostantól docs.microsoft.com/xamarin! Íme néhány részlet a dokumentáció új felhasználói élményéről:
A docs.microsoft.com/xamarin webhelyről minden dokumentációs lehetőségünk néhány kattintással elérhető. Ha a fejlécben lévő Xamarin szóra kattint, bármelyik oldalról visszatérhet ide. A platformhivatkozásokkal megtekintheti mobilfejlesztői dokumentációinkat, és átválthat a Grafika és játékok vagy az Eszközök lapra, ahol további információt talál a kapcsolódó témakörökről, például a SkiaSharpról, a Workbooksról és a Xamarin Live Playerről.
A docs.microsoft.com új lehetőségeket kínál a Xamarin dokumentációjában való navigáláshoz:
- Platformok kezdőlapjai – Áttekintés és rövid összefoglaló az egyes platformokon elérhető dokumentációról. Az egyes platformok oldalát a kék fejlécen szereplő hivatkozásokkal látogathatja meg: Android, iOS, Mac és Xamarin.Forms.
- Keresés – Xamarin-tartalmak kereséséhez kattintson a fejléc jobb oldalán található nagyító ikonra.
- Webhely-navigációs eszközök – A fejléc alatt található webhely-navigációs eszközök segítséget nyújtanak a kapcsolódó dokumentumok megkereséséhez.
- Navigációs fa – Gyors leásás a fanézetben.
- Navigációs szűrő – A navigációs fa szűrése a kívánt témakör fejlécének kereséséhez.
- A cikk tartalma – Minden cikk rendelkezik tartalomjegyzékkel, amely azt is jelzi, hogy éppen a dokumentum melyik részét látja.
- Képek nagyítása – A jobb alsó sarokban nagyítót ábrázoló ikonnal ellátott képek részletesebben megtekinthetők, ha rájuk kattint.
A szakértők és a Xamarin University előadóinak bemutatói és leckéi már beágyazva is elérhetők, mint például ez a Xamarin.Forms-elrendezésekkel foglalkozó témakör:
Minden oldal tartalmaz egy Szerkesztés hivatkozást, így a közösség javításokat és frissítéseket is végrehajthat. A dokumentumokhoz fűzött megjegyzések a visszajelzések követése érdekében GitHub-problémákká alakulnak át. A módosítások elküldéséről a hozzájárulási irányelvekben talál útmutatást.
A Xamarin fejlesztői dokumentációja a különböző fordítási technikák kombinációjának köszönhetően az angol mellett jelenleg 13 nyelven érhető el: kínai (egyszerűsített), kínai (hagyományos), cseh, francia, olasz, koreai, német, japán, lengyel, portugál (brazíliai) orosz, spanyol és török. A nemzetközi funkciókról a Docs-blogban talál további információt.
Előfordulhat, hogy pontosan az Ön által használt kódszerkesztőhöz írt útmutatásra van szüksége, legyen az Visual Studio 2017 vagy Visual Studio for Mac. Ezek az utasítások mostantól minden oldalon külön lapon találhatók:
A kódrészletek szintaxiskiemeléssel vannak kiemelve, és van egy Másolás gomb, amely megkönnyíti a kódrészletek használatát az alkalmazásokhoz:
A Xamarin BCL API-dokumentumok már elérhetők a .NET API-tallózóban, és hamarosan a platformspecifikus API-k is megjelennek.
Akár telefonján, táblagépén, akár asztali számítógépén olvas, a docs.microsoft.com webhely méretezhető, hogy a tartalom világos és könnyen olvasható legyen, miközben a navigáció elérhető marad:
A sötét témát tartalmazó dokumentumok olvasására is lehetőség van!
Látni fogja, hogy bizonyos tartalmak továbbra is a régi webhelyen vannak tárolva, beleértve az API-dokumentumokat, a munkafüzeteket és a mintákat. Csapatunk keményen dolgozik azon, hogy ezen tartalmak migrálásával egységes felhasználói élményt biztosítsunk.
Nehéz szívvel búcsút mondunk a régi webhelyünknek developer.xamarin.com, de izgatott vagyok a docs.microsoft.com/xamarin elérhető új funkciók miatt, és alig várom, hogy még nagyobb, jobb dokumentációs élményt építsünk a Xamarin-fejlesztők számára. Ossza meg velünk a véleményét a fórumon.
P.S.: Ha a régi fejlesztői webhelyre mutató könyvjelzős vagy blogged hivatkozásokat tartalmaz, ne aggódjon: a rendszer automatikusan átirányítja őket az új webhely megfelelő lapjára!