Update copy and metadata for packages and doc site, add logo

Author: anthonyreilly

Directory.Build.props

@@ -12,12 +12,14 @@
     <Authors>Anthony Reilly</Authors>
     <Copyright>2026 Anthony Reilly</Copyright>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
-    <PackageProjectUrl>https://github.com/anthonyreilly/NetCoreForce</PackageProjectUrl>
+    <PackageProjectUrl>https://netcoreforce.com/</PackageProjectUrl>
     <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
-    <PackageTags>salesforce,api,forcedotcom,netstandard,netcore</PackageTags>
+    <!-- shared tags - projects append their own package-specific tags -->
+    <PackageTags>salesforce;salesforce-api;sfdc;force.com;rest;crm;dotnet;csharp;netstandard</PackageTags>
     <RepositoryType>git</RepositoryType>
     <RepositoryUrl>https://github.com/anthonyreilly/NetCoreForce</RepositoryUrl>
-    <PackageReleaseNotes>Release notes and documentation can be found on the project site: https://github.com/anthonyreilly/NetCoreForce</PackageReleaseNotes>
+    <PackageReleaseNotes>v6.0.0 adds .NET 10 and Client Credentials login, and removes EOL .NET Core 3.1 - 7.0 targets. See the CHANGELOG for full details and breaking changes: https://github.com/anthonyreilly/NetCoreForce/blob/main/CHANGELOG.md</PackageReleaseNotes>
+    <PackageIcon>netcoreforce_logo_128px.png</PackageIcon>
 
     <!-- Intentionally targeting EOL frameworks -->
      <CheckEolTargetFramework>false</CheckEolTargetFramework>
@@ -26,6 +28,11 @@
     <SolutionDir>$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), *.sln))</SolutionDir>
   </PropertyGroup>
 
+  <!-- NuGet package icon, included in packable projects only -->
+  <ItemGroup Condition=" '$(IsPackable)' == 'true' ">
+    <None Include="$(MSBuildThisFileDirectory)netcoreforce_logo_128px.png" Pack="true" PackagePath="\" Visible="false" />
+  </ItemGroup>
+
   <PropertyGroup>
     <LibTargetFrameworks>netstandard2.0;netstandard2.1;net8.0;net9.0;net10.0;net462;net472;net48;net481</LibTargetFrameworks>
     <AppTargetFrameworks>net8.0;net9.0;net10.0</AppTargetFrameworks>

README.md

@@ -1,11 +1,33 @@
 # NetCoreForce 
 
-## A .NET Standard and .NET Core Salesforce REST API integration library
+## A Salesforce REST API client library for .NET and C#
 *This project is not offered, sponsored, or endorsed by Salesforce.*
 
-![NuGet Downloads](https://img.shields.io/nuget/dt/NetCoreForce.Client)  
+NetCoreForce lets .NET applications query, create, update and delete Salesforce records through the Salesforce REST API, with OAuth 2.0 login, SOQL and SOSL queries, composite requests, and strongly typed models for Salesforce objects.
 
-[Documentation](https://anthonyreilly.github.io/NetCoreForce/)  
+[![NuGet Version](https://img.shields.io/nuget/v/NetCoreForce.Client)](https://www.nuget.org/packages/NetCoreForce.Client/) [![NuGet Downloads](https://img.shields.io/nuget/dt/NetCoreForce.Client)](https://www.nuget.org/packages/NetCoreForce.Client/)
+
+[Documentation](https://netcoreforce.com/)  
+
+## Install
+
+```
+dotnet add package NetCoreForce.Client
+dotnet add package NetCoreForce.Models
+```
+
+## Quick Start
+
+```csharp
+// Log in with the OAuth Client Credentials flow
+ForceClient client = await ForceClient.FromClientCredentialsAsync(
+    "your-client-id", "your-client-secret", "https://your-domain.my.salesforce.com/services/oauth2/token");
+
+// Query records
+List<SfAccount> accounts = await client.Query<SfAccount>("SELECT Id, Name FROM Account LIMIT 10");
+```
+
+See the [Authentication](https://netcoreforce.com/auth.html) and [Examples](https://netcoreforce.com/examples.html) docs for other login flows and more usage examples.
 
 ## Changes in v6
 
@@ -27,13 +49,14 @@ 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.2+
 - .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)
+For more info on .NET Standard compatibility [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 8.0
 - .NET 9.0
+- .NET 10.0
 - .NET Framework 4.6.2
 - .NET Framework 4.7.2
 - .NET Framework 4.8 & 4.8.1

docfx.json

@@ -33,20 +33,38 @@
       {
         "src": "docs",
         "files": [
-          "images/**"
+          "images/**",
+          "robots.txt"
         ]
+      },
+      {
+        "src": ".",
+        "files": [
+          "netcoreforce_logo_128px.png"
+        ],
+        "dest": "images"
       }
     ],
     "output": "docs/_site",
     "template": [
       "default",
-      "modern"
+      "modern",
+      "docs/template"
     ],
     "globalMetadata": {
       "_appName": "NetCoreForce",
       "_appTitle": "NetCoreForce",
+      "_appLogoPath": "images/netcoreforce_logo_128px.png",
+      "_appFaviconPath": "images/netcoreforce_logo_128px.png",
+      "_description": "NetCoreForce is a Salesforce REST API client library for .NET and C#: OAuth login, SOQL queries, CRUD, composite requests, and generated object models.",
+      "_lang": "en",
       "_enableSearch": true,
       "pdf": false
+    },
+    "sitemap": {
+      "baseUrl": "https://netcoreforce.com/",
+      "changefreq": "weekly",
+      "priority": 0.5
     }
   }
 }

docs/auth.md

@@ -1,3 +1,8 @@
+---
+title: "Salesforce OAuth Authentication in .NET"
+_description: "How to log in to the Salesforce REST API from .NET and C# with NetCoreForce, using the OAuth 2.0 Client Credentials, Web Server, refresh token, and Username-Password flows."
+---
+
 # Authentication
 
 NetCoreForce supports several Salesforce OAuth 2.0 flows. There are two ways to use them:

docs/examples.md

@@ -1,3 +1,8 @@
+---
+title: "Salesforce REST API Examples in C#"
+_description: "C# examples for the Salesforce REST API with NetCoreForce: CRUD, SOQL queries, upsert by external ID, composite requests, SOSL search, file downloads, and metadata."
+---
+
 # Examples
 
 Usage examples for common tasks, starting with everyday CRUD and query operations and moving on to less common ones. For other ways to log in and initialize the client, see [Authentication](auth.md).

docs/index.md

@@ -1,23 +1,47 @@
 ---
 _layout: landing
+title: "NetCoreForce: Salesforce REST API Client for .NET"
+_description: "NetCoreForce is a Salesforce REST API client library for .NET and C#: OAuth login, SOQL queries, CRUD, composite requests, and generated object models."
 ---
 
-- [ForceClient](~/docs/api/NetCoreForce.Client.ForceClient.yml)
-    - [NetcoreForce.Client](~/docs/api/NetCoreForce.Client.yml)
+# NetCoreForce
 
+## A Salesforce REST API client library for .NET and C#
+*This project is not offered, sponsored, or endorsed by Salesforce.*
 
-# NetCoreForce 
+NetCoreForce lets .NET applications query, create, update and delete Salesforce records through the Salesforce REST API, with OAuth 2.0 login, SOQL and SOSL queries, composite requests, and strongly typed models for Salesforce objects.
 
-## A .NET Salesforce REST API integration library
-*This project is not offered, sponsored, or endorsed by Salesforce.*
+![NuGet Version](https://img.shields.io/nuget/v/NetCoreForce.Client) ![NuGet Downloads](https://img.shields.io/nuget/dt/NetCoreForce.Client)
+
+## Install
+
+```
+dotnet add package NetCoreForce.Client
+dotnet add package NetCoreForce.Models
+```
+
+## Quick Start
+
+```csharp
+// Log in with the OAuth Client Credentials flow
+ForceClient client = await ForceClient.FromClientCredentialsAsync(
+    "your-client-id", "your-client-secret", "https://your-domain.my.salesforce.com/services/oauth2/token");
+
+// Query records
+List<SfAccount> accounts = await client.Query<SfAccount>("SELECT Id, Name FROM Account LIMIT 10");
+```
+
+- [Authentication](auth.md) - Client Credentials, Web Server, refresh token, and other login flows
+- [Examples](examples.md) - CRUD, queries, upserts, composite requests, search, metadata and more
+- [API Reference](api/NetCoreForce.Client.ForceClient.yml) - full `ForceClient` reference
 
 ## Library Targets
 
-The primary target is .NET Standard 2.0 to provide the widest possible support. 
+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.2+
 - .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)
+For more info on .NET Standard compatibility [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
@@ -32,55 +56,48 @@ Full target list
 
 All possible frameworks are specifically targeted so that conditional compilation can be done where required.
 
-Full tested support is for .NET Core 8.0 - 10.0 as tooling and tests target those.  
-Legacy .NET Frameworks are partially tested
+Full tested support is for .NET 8.0 - 10.0 as tooling and tests target those.
+Legacy .NET Frameworks are partially tested.
 
-![NuGet Downloads](https://img.shields.io/nuget/dt/NetCoreForce.Client)
+## NuGet Packages
+* [NetCoreForce.Client](https://www.nuget.org/packages/NetCoreForce.Client/) - the Salesforce REST API client
+* [NetCoreForce.Models](https://www.nuget.org/packages/NetCoreForce.Models/) - pre-generated models for standard Salesforce objects
+* [NetCoreForce.ModelGenerator](https://www.nuget.org/packages/NetCoreForce.ModelGenerator/) - .NET CLI tool to generate models for your org, including custom objects and fields
 
-[GitHub Repository](https://github.com/anthonyreilly/NetCoreForce)  
+### [CHANGELOG](https://github.com/anthonyreilly/NetCoreForce/blob/main/CHANGELOG.md)
 
-### NuGet Packages
-* [NetCoreForce.Client](https://www.nuget.org/packages/NetCoreForce.Client/)
-* [NetCoreForce.Models](https://www.nuget.org/packages/NetCoreForce.Models/)
-* [NetCoreForce.ModelGenerator](https://www.nuget.org/packages/NetCoreForce.ModelGenerator/)
+[GitHub Repository](https://github.com/anthonyreilly/NetCoreForce)
 
-### [CHANGELOG](CHANGELOG.md)  
-
-CI main:  
-[![CI](https://github.com/anthonyreilly/NetCoreForce/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/anthonyreilly/NetCoreForce/actions/workflows/ci.yml)  
-CI dev:  
+CI main:
+[![CI](https://github.com/anthonyreilly/NetCoreForce/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/anthonyreilly/NetCoreForce/actions/workflows/ci.yml)
+CI dev:
 [![CI](https://github.com/anthonyreilly/NetCoreForce/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/anthonyreilly/NetCoreForce/actions/workflows/ci.yml)
 
-
-### Projects in this solution:
-* [NetCoreForce.Client](src/NetCoreForce.Client)
-    - Main library  
-* [NetCoreForce.Client.Tests](src/NetCoreForce.Client.Tests)
-    - Unit tests (offline/mocked)  
-* [NetCoreForce.FunctionalTests](src/NetCoreForce.FunctionalTests)
-    - Online Unit tests (Needs valid login credentials)  
-* [NetCoreForce.ModelGenerator](src/NetCoreForce.ModelGenerator)
-    - Check [README](src/NetCoreForce.ModelGenerator/README.md) for docs
-    - Optional custom dotnet-cli tool for code generation of custom objects/fields.  
-* [NetCoreForce.Models](src/NetCoreForce.Models)
-    - Check [README](src/NetCoreForce.Models/README.md) for docs
-    - Optional library with a set of pre-generated standard models  
-* [SampleConsole](src/SampleConsole)
-    - A simple .NET Core console app to demonstrate the library.
-
-
-
-### Designed to minimize dependencies:
+## Projects in this solution
+* [NetCoreForce.Client](https://github.com/anthonyreilly/NetCoreForce/tree/main/src/NetCoreForce.Client)
+    - Main library
+* [NetCoreForce.Client.Tests](https://github.com/anthonyreilly/NetCoreForce/tree/main/src/NetCoreForce.Client.Tests)
+    - Unit tests (offline/mocked)
+* [NetCoreForce.FunctionalTests](https://github.com/anthonyreilly/NetCoreForce/tree/main/src/NetCoreForce.FunctionalTests)
+    - Online Unit tests (Needs valid login credentials)
+* [NetCoreForce.ModelGenerator](https://github.com/anthonyreilly/NetCoreForce/tree/main/src/NetCoreForce.ModelGenerator)
+    - Check [README](https://github.com/anthonyreilly/NetCoreForce/blob/main/src/NetCoreForce.ModelGenerator/README.md) for docs
+    - Optional custom dotnet-cli tool for code generation of custom objects/fields.
+* [NetCoreForce.Models](https://github.com/anthonyreilly/NetCoreForce/tree/main/src/NetCoreForce.Models)
+    - Check [README](https://github.com/anthonyreilly/NetCoreForce/blob/main/src/NetCoreForce.Models/README.md) for docs
+    - Optional library with a set of pre-generated standard models
+* [SampleConsole](https://github.com/anthonyreilly/NetCoreForce/tree/main/src/SampleConsole)
+    - A simple .NET console app to demonstrate the library.
+
+## Designed to minimize dependencies
 * [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json) (JSON Serialization)
 * [System.Text.Encodings.Web](https://www.nuget.org/packages/System.Text.Encodings.Web) (URL formatting)
 * [Microsoft.Bcl.AsyncInterfaces](https://www.nuget.org/packages/Microsoft.Bcl.AsyncInterfaces/)
-    - Only included in .netstandard2.0, .netcoreapp2.0 targets
+    - Only included in .NET Standard 2.0 and .NET Framework targets
     - Provides await using, async disposables
 
 (Migration from Newtonsoft.Json to System.Text.Json is planned)
 
 Feedback and suggestions welcome.
 
 Licensed under the MIT license.
-
-

docs/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://netcoreforce.com/sitemap.xml

docs/template/public/main.css

@@ -0,0 +1,8 @@
+/* custom styles, layered on top of the docfx modern template */
+
+/* scale the 128px logo down to fit the navbar */
+#logo {
+  height: 40px;
+  width: auto;
+  margin-right: 0.5rem;
+}

netcoreforce_logo_128px.png

@@ -6,7 +6,9 @@
     <TargetFrameworks>$(LibTargetFrameworks)</TargetFrameworks>
 
     <!--NuGet-->
-    <Description>A .NET Standard and .NET Core Salesforce REST API integration library</Description>
+    <Title>NetCoreForce Salesforce REST API Client</Title>
+    <Description>Salesforce REST API client library for .NET and C#. OAuth 2.0 login (Client Credentials, Web Server, refresh token), SOQL and SOSL queries, CRUD and upsert, composite requests, and file downloads. Supports .NET 8-10, .NET Standard 2.0/2.1 and .NET Framework 4.6.2+.</Description>
+    <PackageTags>$(PackageTags);soql;sosl;oauth</PackageTags>
     <IsPackable>true</IsPackable>
     <PackageId>NetCoreForce.Client</PackageId>
     <PackageReadmeFile>README.md</PackageReadmeFile>