docs: improve typedocs config to finally make some sense

Author: axe312ger

typedoc.json

@@ -2,23 +2,87 @@
   "name": "contentful-management.js",
   "entryPoints": [
     "lib/index.ts",
-    // "lib/contentful-management.ts",
-    // "lib/plain/plain-client.ts",
+    "lib/create-contentful-api.ts",
+    "lib/plain/plain-client.ts",
+    "lib/plain/checks.ts",
     // "lib/plain/wrappers/wrap.ts",
-    // "lib/contentful-management.ts",
     // "lib/create-adapter.ts",
-    // "lib/create-contentful-api.ts",
     // "lib/entities/app-action.ts",
-    // "lib/entities/environment-template-installation.ts"
+    // "lib/entities/environment-template-installation.ts",
+    "lib/entities/access-token.ts",
+    "lib/entities/api-key.ts",
+    "lib/entities/app-access-token.ts",
+    "lib/entities/app-action-call.ts",
+    "lib/entities/app-action.ts",
+    "lib/entities/app-bundle.ts",
+    "lib/entities/app-definition.ts",
+    "lib/entities/app-details.ts",
+    "lib/entities/app-event-subscription.ts",
+    "lib/entities/app-installation.ts",
+    "lib/entities/app-key.ts",
+    "lib/entities/app-signed-request.ts",
+    "lib/entities/app-signing-secret.ts",
+    "lib/entities/app-upload.ts",
+    "lib/entities/asset-key.ts",
+    "lib/entities/asset.ts",
+    "lib/entities/bulk-action.ts",
+    "lib/entities/comment.ts",
+    "lib/entities/concept-scheme.ts",
+    "lib/entities/concept.ts",
+    "lib/entities/content-type-fields.ts",
+    "lib/entities/content-type.ts",
+    "lib/entities/editor-interface.ts",
+    "lib/entities/entry.ts",
+    "lib/entities/environment-alias.ts",
+    "lib/entities/environment-template-installation.ts",
+    "lib/entities/environment-template.ts",
+    "lib/entities/environment.ts",
+    "lib/entities/extension.ts",
+    "lib/entities/field-type.ts",
+    "lib/entities/function-log.ts",
+    "lib/entities/function.ts",
+    "lib/entities/locale.ts",
+    "lib/entities/oauth-application.ts",
+    "lib/entities/organization-invitation.ts",
+    "lib/entities/organization-membership.ts",
+    "lib/entities/organization.ts",
+    "lib/entities/personal-access-token.ts",
+    "lib/entities/preview-api-key.ts",
+    "lib/entities/release-action.ts",
+    "lib/entities/release.ts",
+    "lib/entities/resource-provider.ts",
+    "lib/entities/resource-type.ts",
+    "lib/entities/resource.ts",
+    "lib/entities/role.ts",
+    "lib/entities/scheduled-action.ts",
+    "lib/entities/snapshot.ts",
+    "lib/entities/space-member.ts",
+    "lib/entities/space-membership.ts",
+    "lib/entities/space.ts",
+    "lib/entities/tag.ts",
+    "lib/entities/task.ts",
+    "lib/entities/team-membership.ts",
+    "lib/entities/team-space-membership.ts",
+    "lib/entities/team.ts",
+    "lib/entities/ui-config.ts",
+    "lib/entities/upload-credential.ts",
+    "lib/entities/upload.ts",
+    "lib/entities/usage.ts",
+    "lib/entities/user-ui-config.ts",
+    "lib/entities/user.ts",
+    "lib/entities/utils.ts",
+    "lib/entities/webhook.ts",
+    "lib/entities/widget-parameters.ts",
+    "lib/entities/workflow-definition.ts",
+    "lib/entities/workflow.ts",
+    "lib/entities/workflows-changelog-entry.ts"
   ],
   "out": "out",
   "includeVersion": true,
-  // "categorizeByGroup": true,
-  // "categoryOrder": ["Core", "Clients", "Entities", "Utilities", "*"],
-  "categoryOrder": ["createClient", "ClientParams", "ContentType", "Entry", "*"],
-  // "groupOrder": ["Variables", "Functions", "*"],
+  "categorizeByGroup": false,
+  "categoryOrder": ["Core", "Plain Client", "Legacy Client", "Entities", "*"],
+  "defaultCategory": "Other",
   "kindSortOrder": [
-    "Reference",
     "Project",
     "Module",
     "Namespace",
@@ -31,6 +95,7 @@
     "Interface",
     "TypeAlias",
     "Variable",
+    "Reference",
     "Accessor",
     "Method",
     "Parameter",
@@ -42,16 +107,20 @@
     "GetSignature",
     "SetSignature"
   ],
+  "groupOrder": ["Functions", "Interfaces", "Modules", "*"],
   "sortEntryPoints": false,
   "readme": "README.md",
   "excludePrivate": false,
   "excludeInternal": false,
   "excludeProtected": false,
   "treatWarningsAsErrors": false,
   "sort": ["source-order"],
-  "plugin": [
-    "typedoc-plugin-missing-exports",
-    "typedoc-github-theme"
-  ],
+  "plugin": ["typedoc-plugin-missing-exports", "typedoc-github-theme"],
   "hideGenerator": true,
-}
+  "includeHierarchySummary": true,
+  "navigation": {
+    "includeGroups": false,
+    "includeCategories": true,
+    "includeFolders": false
+  }
+}