docs: Release notes

docs/docs/assets/css/highlight.css

@@ -1,7 +1,12 @@
 /* Background color of a code snippet */
 .md-typeset code.hljs {
     background-color: #282c34;
-    border-radius: 1vh;
+}
+
+@media only screen and (min-width: 720px) {
+    .md-typeset code.hljs {
+        border-radius: 1vh;
+    }
 }
 
 .md-typeset code.hljs  {

docs/docs/release.md

@@ -0,0 +1,82 @@
+## v1.2.2
+
+Three new filters that allows us to add customise our JSON schema validator.
+
+- `fastendpoints_validator` - Triggered by both middleware's
+- `fastendpoints_schema_validator` - Only triggered for Schema middleware's validators
+- `fastendpoints_response_validator` - Only triggered for Response middleware's validators
+
+```php
+use Opis\JsonSchema\Validator;
+
+add_filter('fastendpoints_validator', function (Validator $validator): Validator {
+    $formatsResolver = $validator->parser()->getFormatResolver();
+    $formatsResolver->registerCallable('integer', 'even', function (int $value): bool {
+        return $value % 2 === 0;
+    });
+
+    return $validator;
+});
+```
+
+!!! info
+    For more customisations check the following links:
+    - [Custom formats](https://opis.io/json-schema/2.x/php-format.html)
+    - [Custom filters](https://opis.io/json-schema/2.x/php-filter.html)
+    - [Custom media types](https://opis.io/json-schema/2.x/php-media-type.html)
+    - [Custom content encoding](https://opis.io/json-schema/2.x/php-content-encoding.html)
+
+## v1.2.1
+
+Using JSON/opis schema loader and resolver which allows us to
+[reference schemas](https://opis.io/json-schema/2.x/references.html) inside
+other schemas.
+
+```php
+// Now we also need to set a prefix while appending a directory. This prefix
+// will be used to reference schemas from inside another schema.
+$router->appendSchemaDir('/my-dir', 'http://www.example.com');
+```
+
+## v1.2.0
+
+We now can take advantage of dependency injection in main handler, middlewares and permission's
+handlers.
+
+```php
+// In the past, the $request parameter was mandatory:
+$router->get('/posts/(?P<ID>[\d]+)', function (WP_REST_Request $request) {
+    return $request->get_param('ID');
+});
+
+// Now you only type what you need
+$router->get('/posts/(?P<ID>[\d]+)', function ($ID) {
+    return $ID;
+});
+```
+
+## v1.1.0
+
+- 100% test coverage
+- Integration tests
+- Middleware support
+- Upgraded PHP version to 8.1
+- Full support for WordPress 6.x versions
+- Updated both Response and Schema to a middleware
+
+```php
+// Middleware example
+class MyCustomMiddleware extends \Wp\FastEndpoints\Contracts\Middleware {
+    public function onRequest(/* Type what you need e.g. $request, URL params*/) {
+        // Called before handling the request
+    }
+
+    public function onResponse(/* Type what you need e.g. $response, $request */) {
+        // Called after the request being handled
+    }
+}
+```
+
+## v1.0.0
+
+Initial release - don't use it!