Tweak changelog and docs

Author: tobyzerner

CHANGELOG.md

@@ -27,17 +27,17 @@ and this project adheres to
 - Remove `Pagination\Concerns\BuildsUrls` trait (replaced by
   `Context::currentUrl()`)
 - Move `Extension\Atomic` to `Extension\Atomic\Atomic`
+- Remove `json_api_response()` helper (use `Context::createResponse()` instead)
 
 ### Added
 
 - Add `Context::createResponse()` method for building JSON:API responses with
   automatic `jsonapi` object inclusion
 - Add `JsonApi::meta()` method for including meta information in the `jsonapi`
   object
-- Add `Resource::links()` method for defining custom resource-level links
-  (including `describedby`)
-- Add `Schema\Link` class for defining rich link objects with metadata
-- Add `JsonApiError::id(string $id)` method for setting error IDs
+- Add support for resource links:
+    - Add `Resource::links()` method for defining custom resource-level links
+    - Add `Schema\Link` class for defining rich link objects with metadata
 - Add `Page::$rangeTruncated` parameter for cursor pagination range truncation
   support
 - Add full support for JSON:API profiles:

docs/context.md

@@ -96,6 +96,6 @@ class Context
     public function activateProfile(string $uri): static;
 
     // Create a JSON:API response with document data
-    public function createResponse(array $document): Response;
+    public function createResponse(array $document = []): Response;
 }
 ```

src/JsonApi.php

@@ -7,7 +7,6 @@
 use Nyholm\Psr7\ServerRequest;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
-use Psr\Http\Message\ServerServerRequestInterface;
 use Psr\Http\Server\RequestHandlerInterface;
 use Tobyz\JsonApiServer\Exception\ErrorProvider;
 use Tobyz\JsonApiServer\Exception\InternalServerErrorException;