add a symlink to root

antora-playbook-local.yml

@@ -15,9 +15,9 @@ content:
   - url: .
     branches: HEAD
     start_path: docs
-  - url: https://github.com/fantkolja/hazelcast-code-samples
-    branches: [ test/docs ]
-    start_path: docs
+#  - url: https://github.com/fantkolja/hazelcast-code-samples
+#    branches: [ test/docs ]
+#    start_path: docs
 #    Uncomment to build Swagger docs locally
 #    These are private repos. You need to do private repository authentication.
 #    See [here](https://docs.antora.org/antora/latest/playbook/private-repository-auth/) how to do that

antora-playbook.yml

@@ -16,9 +16,9 @@ content:
   - url: https://github.com/fantkolja/hazelcast-mono
     branches: [feature/swagger-without-collector]
     start_path: docs/rest
-  - url: https://github.com/fantkolja/hazelcast-code-samples
-    branches: [test/docs]
-    start_path: docs
+#  - url: https://github.com/fantkolja/hazelcast-code-samples
+#    branches: [test/docs]
+#    start_path: docs
 ui:
   bundle:
     url: https://github.com/hazelcast/hazelcast-docs-ui/releases/latest/download/ui-bundle.zip #../hazelcast-docs-ui/build/ui-bundle.zip

docs/modules/ROOT/pages/ask-ai.adoc

@@ -4,9 +4,34 @@
 {description}
 
 == Overview
+image:ask_ai.png[Ask AI,role="related thumb right"] You can use the *Ask AI* feature available on every docs page to get answers to your technical questions. The chatbot has indexed all Hazelcast documentation, including standalone API docs microsites, and selected hazelcast.com and support content. The AI uses the information from the knowledge sources to answer questions and does not make up information if it's not listed in the sources.
 
-External code example 1
+To use Ask AI, click the *Ask AI* button in the bottom right of any docs.hazelcast.com page.
+
+Ask AI currently indexes the following sources:
+
+- docs.hazelcast.com (the /latest version for all products and tools)
+- API docs for languages and clients (Javadoc, C++, .NET/C#, Node.js, Python, Go)
+- hazelcast.com/blog (from last two years)
+- hazelcast.com/developers/clients
+- support.hazelcast.com
+- Hazelcast Code Samples repository
+
+IMPORTANT: This is an experimental custom LLM for answering technical questions about Hazelcast. Answers are based *only* on Hazelcast documentation and support sources, but may not be fully accurate so please use your best judgement.
+
+== Tips
+
+- Don't forget to rate the answers using the voting buttons. And please give detailed feedback if the answers you receive aren't correct or could be improved, as this feedback helps us improve Ask AI!
+- You can ask follow up questions or clarify the scope or use case to focus the conversation and get the information you're looking for.
+- You can also ask the chatbot to identify problems in code or configuration files, or create, for example, a pom.xml with certain features enabled.
+- Answers are all based on English language content (see sources listed above) but you can ask and receive answers in different languages.
+- If the answer is not documented in the indexed sources then Ask AI will be unable to provide an answer (feedback is especially welcome in cases where you would expect the answer to be documented and indexed).
+
+NOTE: To learn more about Ask AI and discover some useful examples, check out this related https://hazelcast.com/blog/get-instant-answers-with-ask-ai-on-hazelcast-documentation/?utm_source=docs-website[Ask AI blog].
+
+== Search
+
+You can also use the *Search* tab within Ask AI to search the same sources, and toggle between Search and Ask AI mode.
+
+image:ask_ai_search.png[Search with Ask AI]
 
-----
-include::ROOT:example$/cluster-split-brain-protection/src/main/java/ClusterSplitBrainProtection.java[ClusterSplitBrainProtection.java]
-----

docs/modules/maintain-cluster/pages/rest-api-swagger.adoc

@@ -2,4 +2,4 @@
 :page-enterprise: true
 :page-layout: swagger
 
-swagger_ui::../{attachmentsdir}/api-docs.yaml[]
+swagger_ui::{attachmentsdir}/api-docs.yaml[]