Swagger-Dokumentation für eigene API
In einem der letzten Beiträge habe ich ja bereits gezeigt, wie wir eine einfache ASP.NET Core API entwickelt haben, welche eine Todo-Liste ersetzen soll. In diesem Beitrag möchte ich euch nun zeigen, wie ihr eine Dokumentation für eure API nutzen kann, welche auch noch interaktiv ist, so dass ihr direkt Calls gegen das Backend ausführen könnt.
Xamarin Dokumenation unter neuer Location
Microsoft hat begonnen die gesamten Dokumentationen von Xamarin und Xamarin.Forms zu docs.microsoft.com zu migrieren. Gleichzeitig wurden die Dokumentation auch auf GitHub veröffentlicht, so dass man jetzt schnell eigene Anpassungen daran vornehmen kann und so eine durch die Community getriebene (nahezu) vollständige Dokumentation erstehen wird.
Xamarin Workbooks – Interaktive Dokumentationen schreiben
In diesem Beitrag möchte ich euch die Xamarin Workbooks näher vorstellen und aufzeigen, wie ihr mit simplen Schritten eine eigene interaktive Dokumentation schreiben könnt, welche die Nutzer anschließend an ihren eigenen Geräten “bearbeiten” können. Sofern ihr bereits eine Entwicklungsumgebung bestehend aus Visual Studio mit Xamarin installiert habt, steht euch das Tool Xamarin Workbooks bereits zur Verfügung und ihr könnt dies einfach in der Liste der installierten Programme finden und entsprechend starten. Solltet ihr nicht selbst über Visual Studio auf eurem Rechner verfügen, so könnt ihr das Tool direkt bei Xamarin herunterladen.