doc updates

Author: anthonyreilly

README.md

@@ -3,15 +3,35 @@
 ## A .NET Standard and .NET Core Salesforce REST API integration library
 *This project is not offered, sponsored, or endorsed by Salesforce.*
 
-Targets:  
-    - .NET Standard 2.0 : widest possible support including .NET Framework 4.6.1+ and .NET Core 2.0+  
-    - .NET Standard 2.1 : for newer .NET Core versions
+![NuGet Downloads](https://img.shields.io/nuget/dt/NetCoreForce.Client)  
 
-For more info on .NET Standard compatiblity [see the Microsoft documentation here](https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0)
+[Documentation](https://anthonyreilly.github.io/NetCoreForce/)  
 
-Full tested support is for .NET Core 6.0 - 9.0 as tooling and tests target those.
+## Library Targets
 
-![NuGet Downloads](https://img.shields.io/nuget/dt/NetCoreForce.Client)  
+The primary target is .NET Standard 2.0 to provide the widest possible support. 
+- .NET Standard 2.0 for widest possible support including .NET Framework 4.6.1+ and .NET Core 2.0
+- .NET Standard 2.1 for newer .NET Core versions
+
+For more info on .NET Standard compatiblity [see the Microsoft documentation here](https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0)
+
+Full target list
+- .NET Standard 2.0
+- .NET Standard 2.1
+- .NET Core 3.1
+- .NET 5.0
+- .NET 6.0
+- .NET 7.0
+- .NET 8.0
+- .NET 9.0
+- .NET Framework 4.6.2
+- .NET Framework 4.7.2
+- .NET Framework 4.8
+
+All possible frameworks are specifically targeted so that conditional compilation can be done where required.
+
+Full tested support is for .NET Core 6.0 - 9.0 as tooling and tests target those.  
+Legacy .NET Frameworks are partially tested
 
 ### [CHANGELOG](CHANGELOG.md)  
 

docs/getting-started.md

@@ -2,7 +2,7 @@
 
 
 
-### Basic Usage Example
+## Basic Usage Example
 
 ```csharp
 ///Initialize the authentication client
@@ -25,14 +25,17 @@ await client.DeleteRecord(SfAccount.SObjectTypeName, acct.Id);
 //Get the results of a SOQL query
 List<SfCase> cases = await client.Query<SfCase>("SELECT Id,CaseNumber,Account.Name,Contact.Name FROM Case");
 ```
+---
 
-### Nested Query Results
+## Nested Query Results
 
 When you include related objects in a SOQL query:
 ```
 SELECT Id,CaseNumber,Account.Name,Contact.Name FROM Case
 ```
 
+[```Query<T>```](xref:NetCoreForce.Client.ForceClient.Query``1(System.String,System.Boolean)). 
+
 And get the results via the client, you can then access the related objects and fields included in the query in a fluent manner.
 ```csharp
 List<SfCase> cases = await client.Query<SfCase>("SELECT Id,CaseNumber,Account.Name,Contact.Name FROM Case");
@@ -47,11 +50,14 @@ Nested queries are not fully supported - the subquery results will not be comple
 // *NOT* fully supported
 "SELECT Id,CaseNumber, (Select Contact.Name from Account) FROM Case"
 ```
+---
 
-### Asynchronous Batch Processing
+## Asynchronous Batch Processing
 
-Query<T> method will retrieve the full result set before returning. By default, results are returned in batches of 2000.
-In cases where you are working with large result sets, you may want to use QueryAsync<T> to retrieve the batches asynchronously for better performance.
+[```Query<T>```](xref:NetCoreForce.Client.ForceClient.Query``1(System.String,System.Boolean)) method will retrieve the full result set before returning. By default, results are returned in batches of 2000.
+In cases where you are working with large result sets, you may want to use
+[```QueryAsync<T>```](xref:NetCoreForce.Client.ForceClient.QueryAsync``1(System.String,System.Boolean,System.Nullable{System.Int32},System.Threading.CancellationToken))
+to retrieve the batches asynchronously for better performance.
 
 ```csharp
 // First create the async enumerable. At this point, no query has been executed.
@@ -69,4 +75,12 @@ await using (IAsyncEnumerator<SfContact> contactsEnumerator = contactsEnumerable
         // process your results
     }
 }
-```
+``` 
+
+---
+
+## Multiple and Single Resultsets
+
+By defualt, the [```Query<T>```](xref:NetCoreForce.Client.ForceClient.Query``1(System.String,System.Boolean)) returns a ```List<T>```.
+When you know the result will be a single record, you can use the [```QuerySingle<T>```](xref:NetCoreForce.Client.ForceClient.QuerySingle``1(System.String,System.Boolean)) method.
+

docs/index.md

@@ -2,19 +2,40 @@
 _layout: landing
 ---
 
-
-
-* [ForceClient](~/api/NetCoreForce.Client.ForceClient.yml)
-    -[NetcoreForce.Client](~/api/NetCoreForce.Client.yml)
+- [ForceClient](~/api/NetCoreForce.Client.ForceClient.yml)
+    - [NetcoreForce.Client](~/api/NetCoreForce.Client.yml)
 
 
 # NetCoreForce 
 
 ## A .NET Salesforce REST API integration library
 *This project is not offered, sponsored, or endorsed by Salesforce.*
 
-Targets .NET Standard 2.0 - this means it will be generally compatible with .NET Framework 4.6.1+ and .NET Core 2.0+  
-For more info on .NET Standard 2.0 compatiblity [see the Microsoft documentation here](https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0)
+## Library Targets
+
+The primary target is .NET Standard 2.0 to provide the widest possible support. 
+- .NET Standard 2.0 for widest possible support including .NET Framework 4.6.1+ and .NET Core 2.0
+- .NET Standard 2.1 for newer .NET Core versions
+
+For more info on .NET Standard compatiblity [see the Microsoft documentation here](https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0)
+
+Full target list
+- .NET Standard 2.0
+- .NET Standard 2.1
+- .NET Core 3.1
+- .NET 5.0
+- .NET 6.0
+- .NET 7.0
+- .NET 8.0
+- .NET 9.0
+- .NET Framework 4.6.2
+- .NET Framework 4.7.2
+- .NET Framework 4.8
+
+All possible frameworks are specifically targeted so that conditional compilation can be done where required.
+
+Full tested support is for .NET Core 6.0 - 9.0 as tooling and tests target those.  
+Legacy .NET Frameworks are partially tested
 
 Full tested support is for .NET Core 6.0 - 9.0 as tooling and tests target those.