Merge pull request #28 from eadwinCode/doc_update

Pagination Doc update

Author: eadwinCode

docs/tutorial/pagination.md

@@ -9,6 +9,17 @@
 - func_or_pgn_class: Defines a route function or a Pagination Class. default: `ninja_extra.pagination.LimitOffsetPagination`
 - paginator_params: extra parameters for initialising Pagination Class
 
+!!! info
+    When using `ninja_extra.pagination.LimitOffsetPagination`, you should use `NinjaPaginationResponseSchema` as pagination response schema wrapper
+    eg: 
+    ```python
+    
+    @route.get('', response=NinjaPaginationResponseSchema[UserSchema])
+    @paginate()
+    def list_items(self):
+        return item_model.objects.all()
+    ```
+
 ### Changing Default Pagination Class
 To change the default pagination class, you need to add a `NINJA_EXTRA` variable in `settings.py` with a key `PAGINATION_CLASS` and value defining path to pagination class
 ```python

ninja_extra/main.py

@@ -1,5 +1,5 @@
 from importlib import import_module
-from typing import Callable, Dict, List, Optional, Sequence, Tuple, Type, Union
+from typing import Any, Callable, Dict, List, Optional, Sequence, Tuple, Type, Union
 
 from django.core.exceptions import ImproperlyConfigured
 from django.http import HttpRequest, HttpResponse
@@ -9,7 +9,6 @@
 from ninja.constants import NOT_SET
 from ninja.parser import Parser
 from ninja.renderers import BaseRenderer
-from ninja.types import TCallable
 
 from ninja_extra import exceptions, router
 from ninja_extra.compatible import NOT_SET_TYPE
@@ -30,26 +29,26 @@ def __init__(
         description: str = "",
         openapi_url: Optional[str] = "/openapi.json",
         docs_url: Optional[str] = "/docs",
-        docs_decorator: Optional[Callable[[TCallable], TCallable]] = None,
         urls_namespace: Optional[str] = None,
         csrf: bool = False,
         auth: Union[Sequence[Callable], Callable, NOT_SET_TYPE] = NOT_SET,
         renderer: Optional[BaseRenderer] = None,
         parser: Optional[Parser] = None,
         app_name: str = "ninja",
+        **kwargs: Any,
     ) -> None:
         super(NinjaExtraAPI, self).__init__(
             title=title,
             version=version,
             description=description,
             openapi_url=openapi_url,
             docs_url=docs_url,
-            docs_decorator=docs_decorator,
             urls_namespace=urls_namespace,
             csrf=csrf,
             auth=auth,
             renderer=renderer,
             parser=parser,
+            **kwargs,
         )
         self.app_name = app_name
         self.exception_handler(exceptions.APIException)(self.api_exception_handler)