Documentation updates for v4 (#741)

* Documentation updates for v4

Author: Bart Koelman

README.md

@@ -36,7 +36,7 @@ See the [examples](https://github.com/json-api-dotnet/JsonApiDotNetCore/tree/mas
 
 ## Installation And Usage
 
-See [the documentation](https://json-api-dotnet.github.io/#/) for detailed usage. 
+See [the documentation](https://json-api-dotnet.github.io/#/) for detailed usage.
 
 ### Models
 
@@ -56,7 +56,7 @@ public class ArticlesController : JsonApiController<Article>
         public ArticlesController(
             IJsonApiOptions jsonApiOptions,
             IResourceService<Article> resourceService,
-            ILoggerFactory loggerFactory) 
+            ILoggerFactory loggerFactory)
             : base(jsonApiOptions, resourceService, loggerFactory)
         { }
 }
@@ -65,7 +65,7 @@ public class ArticlesController : JsonApiController<Article>
 ### Middleware
 
 ```csharp
-public class Startup 
+public class Startup
 {
     public IServiceProvider ConfigureServices(IServiceCollection services) {
         services.AddJsonApi<AppDbContext>();
@@ -89,7 +89,7 @@ dotnet restore
 
 #### Testing
 
-Running tests locally requires access to a PostgreSQL database.  If you have docker installed, this can be propped up via: 
+Running tests locally requires access to a PostgreSQL database.  If you have docker installed, this can be propped up via:
 
 ```bash
 docker run --rm --name jsonapi-dotnet-core-testing  -e POSTGRES_DB=JsonApiDotNetCoreExample -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -p 5432:5432 postgres:12.0

docs/README.md

@@ -3,4 +3,4 @@
 ```
 ./generate.sh
 docfx ./docfx.json --serve
-```
+```

docs/api/index.md

@@ -5,6 +5,5 @@ This section documents the package API and is generated from the XML source comm
 ## Common APIs
 
 - [`JsonApiOptions`](JsonApiDotNetCore.Configuration.JsonApiOptions.html)
-- [`IResourceGraph`](JsonApiDotNetCore.Internal.IResourceGraph.html)
+- [`IResourceGraph`](JsonApiDotNetCore.Internal.Contracts.IResourceGraph.html)
 - [`ResourceDefinition<T>`](JsonApiDotNetCore.Models.ResourceDefinition-1.html)
-- [`IQueryAccessor`](JsonApiDotNetCore.Services.IQueryAccessor.html)

docs/generators/index.md

@@ -16,19 +16,3 @@ Install-Package JsonApiDotnetCore
   <PackageReference Include="JsonApiDotNetCore" Version="3.0.0" />
 </ItemGroup>
 ```
-
-## Pre-Release Packages
-
-Occasionally we will release experimental features as pre-release packages on our
-MyGet feed. You can download these by adding [the pacakge feed](https://www.myget.org/feed/Details/research-institute) to your nuget configuration.
-
-These releases are deployed from the `develop` branch directly.
-
-```xml
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
-  <packageSources>
-    <add key="JADNC Pre-Release" value="https://www.myget.org/F/research-institute/api/v3/index.json" />
-  </packageSources>
-</configuration>
-```

docs/getting-started/install.md

@@ -1,6 +1,6 @@
 # Step-By-Step Guide to a Running API
 
-The most basic use case leverages Entity Framework. 
+The most basic use case leverages Entity Framework Core.
 The shortest path to a running API looks like:
 
 - Create a new web app
@@ -33,45 +33,45 @@ Install-Package JsonApiDotnetCore
 ```
 
 ### Define Models
-        
+
 Define your domain models such that they implement `IIdentifiable<TId>`.
-The easiest way to do this is to inherit `Identifiable`
+The easiest way to do this is to inherit from `Identifiable`
 
 ```c#
 public class Person : Identifiable
-{ 
+{
     [Attr("name")]
     public string Name { get; set; }
 }
 ```
 
 ### Define DbContext
-        
+
 Nothing special here, just an ordinary `DbContext`
 
 ```
 public class AppDbContext : DbContext
 {
     public AppDbContext(DbContextOptions<AppDbContext> options)
         : base(options) { }
-        
+
     public DbSet<Person> People { get; set; }
 }
 ```
 
 ### Define Controllers
-        
-You need to create controllers that inherit from `JsonApiController<TEntity>` or `JsonApiController<TEntity, TId>`
-where `TEntity` is the model that inherits from `Identifiable<TId>`
+
+You need to create controllers that inherit from `JsonApiController<T>` or `JsonApiController<T, TId>`
+where `T` is the model that inherits from `Identifiable<TId>`
 
 ```c#
 public class PeopleController : JsonApiController<Person>
 {
     public PeopleController(
-        IJsonApiContext jsonApiContext,
-        IResourceService<Person> resourceService,
-        ILoggerFactory loggerFactory) 
-    : base(jsonApiContext, resourceService, loggerFactory)
+        IJsonApiOptions jsonApiOptions,
+        ILoggerFactory loggerFactory,
+        IResourceService<Person> resourceService)
+    : base(jsonApiOptions, loggerFactory, resourceService)
     { }
 }
 ```
@@ -81,24 +81,26 @@ public class PeopleController : JsonApiController<Person>
 Finally, add the services by adding the following to your Startup.ConfigureServices:
 
 ```c#
-public IServiceProvider ConfigureServices(IServiceCollection services)
+// This method gets called by the runtime. Use this method to add services to the container.
+public void ConfigureServices(IServiceCollection services)
 {
-    // add the db context like you normally would
+    // Add the Entity Framework Core DbContext like you normally would
     services.AddDbContext<AppDbContext>(options =>
-    { // use whatever provider you want, this is just an example
+    {
+        // Use whatever provider you want, this is just an example
         options.UseNpgsql(GetDbConnectionString());
-    }, ServiceLifetime.Transient);
+    });
 
-    // add jsonapi dotnet core
+    // Add JsonApiDotNetCore
     services.AddJsonApi<AppDbContext>();
-    // ...
 }
 ```
 
-Add the middleware to the Startup.Configure method. Note that under the hood, 
-this will call `app.UseMvc()` so there is no need to add that as well.
+Add the middleware to the Startup.Configure method. Note that under the hood,
+this will call `app.UseRouting()` and `app.UseEndpoints(...)` so there is no need to add that as well.
 
 ```c#
+// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
 public void Configure(IApplicationBuilder app)
 {
     app.UseJsonApi();
@@ -110,19 +112,19 @@ public void Configure(IApplicationBuilder app)
 One way to seed the database is in your Configure method:
 
 ```c#
-public void Configure(
-    IApplicationBuilder app,
-    AppDbContext context)
+public void Configure(IApplicationBuilder app, AppDbContext context)
 {
     context.Database.EnsureCreated();
-    if(context.People.Any() == false) 
+
+    if (!context.People.Any())
     {
-        context.People.Add(new Person {
+        context.People.Add(new Person
+        {
             Name = "John Doe"
         });
         context.SaveChanges();
     }
-    // ...
+
     app.UseJsonApi();
 }
 ```

docs/getting-started/step-by-step.md

@@ -6,10 +6,10 @@ A [{ json:api }](https://jsonapi.org) web application framework for .Net Core.
 
 ### 1. Eliminate Boilerplate
 
-The goal of this package is to facility the development of json:api applications that leverage the full range 
+The goal of this package is to facility the development of json:api applications that leverage the full range
 of features provided by the specification.
 
-Eliminate CRUD boilerplate and provide the following features across all your resource endpoints: 
+Eliminate CRUD boilerplate and provide the following features across all your resource endpoints:
 
 - Relationship inclusion and navigation
 - Filtering

docs/index.md

@@ -1,5 +1,4 @@
 curl -vs http://localhost:5001/api/people           \
-    -H "Accept: application/vnd.api+json"           \
     -H "Content-Type: application/vnd.api+json"     \
     -d '{
             "data": {

docs/request-examples/000-CREATE_Person.sh

@@ -1,5 +1,4 @@
 curl -vs http://localhost:5001/api/articles         \
-    -H "Accept: application/vnd.api+json"           \
     -H "Content-Type: application/vnd.api+json"     \
     -d '{
             "data": {

docs/request-examples/001-CREATE_Article.sh

@@ -1,2 +1 @@
-curl -vs http://localhost:5001/api/articles     \
-    -H "Accept: application/vnd.api+json"
+curl -vs http://localhost:5001/api/articles