refactor: simplify the API documentation page (#323)

This will correct the API documentation and simplify the code base.

See also:
  * https://www.drupal.org/node/3000458
  * https://www.drupal.org/node/3000609

Author: e0ipso

composer.json

@@ -34,7 +34,12 @@
         "type:drupal-drush"
       ]
     },
-    "patches": {}
+    "patches": {
+      "drupal/openapi": {
+        "Exclude disabled JSON API resources": "https://www.drupal.org/files/issues/2018-09-18/3000458--exclude-disabled-resource-types--2.patch",
+        "Documentation for JSON API collections needs minor adjustments": "https://www.drupal.org/files/issues/2018-09-18/3000609--jsonapi-collections-fixes--2.patch"
+      }
+    }
   },
   "require": {
     "cweagans/composer-patches": "^1.6.0",

modules/contenta_enhancements/contenta_enhancements.info.yml

@@ -4,3 +4,4 @@ core: 8.x
 type: module
 dependencies:
   - simple_oauth
+  - openapi

modules/contenta_enhancements/contenta_enhancements.links.task.yml

@@ -1,20 +1,21 @@
 contenta_enhancements.api:
   path: '/admin/api'
   defaults:
-    _controller: '\Drupal\contenta_enhancements\Controller\OpenApiDocs::generateDocs'
-    entity_mode: 'content_entities'
-  methods: [GET]
-  requirements:
-    _permission: 'access openapi api docs'
-
-contenta_enhancements.api.config:
-  path: '/admin/api/config'
-  defaults:
-    _controller: '\Drupal\contenta_enhancements\Controller\OpenApiDocs::generateDocs'
-    entity_mode: 'config_entities'
-  methods: [GET]
+    _title: 'OpenAPI Documentation'
+    _controller: '\Drupal\openapi\Controller\OpenApiUiController::generate'
+    openapi_ui: redoc
+    openapi_generator: jsonapi
+  methods:
+  - GET
   requirements:
     _permission: 'access openapi api docs'
+    _module_dependencies: 'openapi_ui'
+  options:
+    parameters:
+      openapi_ui:
+        type: openapi_ui
+      openapi_generator:
+        type: openapi_generator
 
 contenta_enhancements.revert:
   path: '/admin/contenta/revert'