documentation updates

Author: rthomasv3

README.md

@@ -1,8 +1,79 @@
 # About
-This is an unofficial SDK for using the [Turso Platform API](https://docs.turso.tech/api-reference/introduction) in C#. It currently supports all available `v1` endpoints.
+This is an unofficial SDK for using the [Turso Platform API](https://docs.turso.tech/api-reference/introduction) in C#. It supports all available `v1` endpoints.
+
+# Setup
+Complete setup information can be found in the [Turso quickstart guide](https://docs.turso.tech/api-reference/quickstart).
+
+1. First [install the Turso CLI](https://docs.turso.tech/cli/installation).
+2. Use the CLI to get your account user or organization slug.
+	```
+	turso org list
+	```
+3. Create a platform API token.
+	```
+	turso auth api-tokens mint quickstart
+	```
 
 # Usage
-There are a few different ways to use the 
+First install the package:
+```
+dotnet add package rthomasv3.TursoPlatformApi
+```
+
+The services and methods are a one-to-one mapping with the Turso documentation.
+
+For example, to list all databases:
+```c#
+await tursoPlatformService.Databases.List();
+```
+ 
+| Service     | Usage     |
+| ------------- | ------------- |
+| ITursoPlatformService | The overall platform service with properties for all other services. |
+| ITursoDatabaseService | Manage databases. |
+| ITursoGroupService | Manage groups. |
+| ITursoLocationService | View locations. |
+| ITursoOrganizationsService | Manage organizations. |
+| ITursoMembersService | Manage members. |
+| ITursoInvitesService | Manage invites. |
+| ITursoAuditLogsService | View audit logs. |
+| ITursoApiTokensService | Manage platform API tokens. |
+
+The easiest way to use the Turso Platform API Service is using dependency injection.
+
+## Dependency Injection
+Add a `TursoPlatformApi` section to your `appsettings.json` file. Use `appsettings.Development.json` to avoid keys ending up in your repo.
+
+```json
+{
+  "TursoPlatformApi": {
+    "DefaultOrganizationSlug": "<your-organization-slug>",
+    "AuthToken": "<your-api-token>"
+  }
+}
+```
+
+After that you can add Turso Platform API Service using the provided services extension method.
+
+```c#
+builder.Services.AddTursoPlatformService();
+```
+
+Then you can add any of the API services to the constructors in your application.
+
+## Instance
+You can also create and use an instance directly if you prefer.
 
+```c#
+// create a new instance
+var tursoPlatformApi = new TursoPlatformApi.TursoPlatformService("<your-organization-slug>", "<your-api-token>");
+var allGroups = await tursoPlatformApi.Groups.List();
+```
 
+or 
 
+```c#
+// static instance
+TursoPlatformApi.TursoPlatformService.Initialize("<your-organization-slug>", "<your-api-token>");
+var allDatabases = await TursoPlatformApi.TursoPlatformService.Instance.Databases.List();
+```

TursoPlatformExtensions.cs

@@ -6,8 +6,16 @@
 
 namespace TursoPlatformApi
 {
+    /// <summary>
+    /// Extension methods used to setup the Turso platform API for dependency injection.
+    /// </summary>
     public static class TursoPlatformExtensions
     {
+        /// <summary>
+        /// Adds the Turso API services using the configuration from appsettings.json.
+        /// </summary>
+        /// <param name="services">The services collection.</param>
+        /// <returns>The services collection.</returns>
         public static IServiceCollection AddTursoPlatformService(this IServiceCollection services)
         {
             TursoAppSettings appSettings = new TursoAppSettings();
@@ -22,7 +30,7 @@ public static IServiceCollection AddTursoPlatformService(this IServiceCollection
 
             if (tursoSection.Exists())
             {
-                appSettings.DefaultOrganizationSlug = tursoSection["OrganizationSlug"];
+                appSettings.DefaultOrganizationSlug = tursoSection["DefaultOrganizationSlug"];
                 appSettings.AuthToken = tursoSection["AuthToken"];
             }
 
@@ -31,6 +39,13 @@ public static IServiceCollection AddTursoPlatformService(this IServiceCollection
             return services;
         }
 
+        /// <summary>
+        /// Adds the Turso API services using the provided configuration.
+        /// </summary>
+        /// <param name="services">The services collection.</param>
+        /// <param name="organizationSlug">The default organization slug to use when not provided to the method.</param>
+        /// <param name="authToken">Your Turso platform API auth token.</param>
+        /// <returns>The services collection.</returns>
         public static IServiceCollection AddTursoPlatformService(this IServiceCollection services, string organizationSlug, string authToken)
         {
             TursoAppSettings appSettings = new TursoAppSettings()