DOC-305: orphan pages detector (#428)

Implements https://hazelcast.atlassian.net/browse/DOC-305

Please note, we probably can close
https://hazelcast.atlassian.net/browse/DOC-304 if this implementation is
OK

.github/workflows/validate.yml

@@ -1,4 +1,4 @@
-name: Check for dead links
+name: Docs validation
 
 on:
   pull_request:
@@ -13,5 +13,5 @@ jobs:
     steps:
       - name: Checkout Current Repo
         uses: actions/checkout@v4
-      - name: Check dead links
+      - name: Validate Docs
         uses: hazelcast/hazelcast-docs/.github/actions/validate@main

antora-playbook-local.yml

@@ -36,5 +36,5 @@ asciidoc:
     docs-archive: 'https://hazelcast.org/imdg/download/archives/'
     hazelcast-cloud: Cloud
   extensions:
-    - ./lib/tabs-block.js
-    - ./lib/swagger-ui-block-macro.js
+    - ./node_modules/hazelcast-docs-tools/antora-macro/tabs-block.js
+    - ./node_modules/hazelcast-docs-tools/antora-macro/swagger-ui-block-macro.js

antora-playbook.yml

@@ -35,5 +35,5 @@ asciidoc:
     docs-archive: 'https://hazelcast.org/imdg/download/archives/'
     hazelcast-cloud: Cloud
   extensions:
-    - ./lib/tabs-block.js
-    - ./lib/swagger-ui-block-macro.js
+    - ./node_modules/hazelcast-docs-tools/antora-macro/tabs-block.js
+    - ./node_modules/hazelcast-docs-tools/antora-macro/swagger-ui-block-macro.js

docs/modules/getting-started/partials/nav.adoc

@@ -6,4 +6,4 @@
 ** User Interface Overview
 *** xref:getting-started:user-interface.adoc[Top Bar and Side Bar]
 *** xref:getting-started:graphs.adoc[]
-*** xref:getting-started:tables.adoc[]
+*** xref:getting-started:tables.adoc[]

package.json

@@ -2,18 +2,20 @@
   "name": "hazelcast-docs-playbook",
   "version": "1.0.0",
   "description": "Hazelcast Antora project.",
-  "author": "SerdarO",
+  "author": "Hazelcast Docs",
   "license": "ISC",
   "scripts": {
     "build": "antora --to-dir docs --fetch antora-playbook.yml",
     "build-local": "antora --to-dir test --fetch antora-playbook-local.yml",
+    "check-orphan-pages": "check-orphan-pages --log-failure-level=error",
     "serve": "serve test",
     "expose": "ngrok http 5000"
   },
   "devDependencies": {
     "@antora/cli": "^3.1.1",
     "@antora/site-generator": "^3.1.1",
     "asciidoctor-kroki": "^0.10.0",
+    "hazelcast-docs-tools": "github:hazelcast/hazelcast-docs-tools#v1.1.0",
     "ngrok": "^4.2.2",
     "serve": "^13.0.2"
   }