more descriptions

Author: fhennig

modules/reference/pages/duration.adoc

@@ -1,10 +1,10 @@
 = Duration format
 :page-aliases: concepts:duration.adoc
-
 :rust-duration-max: https://doc.rust-lang.org/std/time/struct.Duration.html#associatedconstant.MAX
 :go-std-time: https://cs.opensource.google/go/go/+/refs/tags/go1.21.2:src/time/format.go;l=1589
 :k8s-cr: https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/
 :go: https://go.dev/
+:description: nderstand the human-readable duration format used by Stackable operators, based on Go's time.ParseDuration, with units like days, hours, minutes, and seconds.
 
 All Stackable operators use a human-readable duration format. It very closely resembles the format used by the {go}[Go] programming language - which Kubernetes uses internally.
 Every duration field of a {k8s-cr}[CustomResource], for example, the xref:trino:usage-guide/operations/graceful-shutdown.adoc[`spec.workers.roleConfig.gracefulShutdownTimeout`] field, supports this format.

modules/reference/pages/glossary.adoc

@@ -1,5 +1,6 @@
 = Glossary
 :li: pass:[<i class="fa-solid fa-link fa-sm" style="margin-left: 5px; vertical-align: baseline;"></i>]
+:description: Glossary of Stackable terms, including "Role," "Role Group," and "Stacklet," with definitions and links to detailed explanations.
 
 // refined styling for the glossary
 ++++
@@ -54,4 +55,4 @@ Learn more about xref:concepts:stacklet.adoc#role-groups[role groups].
 A Stacklet is defined by a custom resource like AirflowCluster or DruidCluster.
 The term refers to the defining resource and all the resources that belong to it, which are created by the operator, such as StatefulSets, Services, Secrets and ConfigMaps.
 All objects together are the Stacklet.
-====
+====

modules/tutorials/pages/authentication_with_openldap.adoc

@@ -1,15 +1,18 @@
 = Authentication with OpenLDAP
+:kind: https://kind.sigs.k8s.io/
+:k9s: https://k9scli.io/
+:description: Learn how to set up LDAP authentication for Stackable's Superset and Trino products, including installing OpenLDAP and configuring authentication classes.
 
 The Stackable platform supports user authentication with LDAP in multiple products. This page guides you through setting
 up the configuration necessary to use an existing LDAP installation with Stackable supported products. You can learn
 more about authentication in the Stackable Platform on the xref:concepts:authentication.adoc[concepts page].
 
 Prerequisites:
 
-* a k8s cluster available, or https://kind.sigs.k8s.io/[kind] installed
+* a k8s cluster available, or {kind}[kind] installed
 * xref:management:stackablectl:index.adoc[] installed
 * basic knowledge of how to create resources in Kubernetes (i.e. `kubectl apply -f <filename>.yaml`) and inspect them
-  (`kubectl get` or a tool like https://k9scli.io/[k9s])
+  (`kubectl get` or a tool like {k9s}[k9s])
 
 == Setup
 

modules/tutorials/pages/index.adoc

@@ -1,4 +1,5 @@
 = Tutorials
+:description: Explore Stackable Data Platform tutorials for feature setup, product operators, and getting started guides for Airflow, Druid, HBase, and more.
 
 Tutorials help you learn about a specific aspect of the Stackable Data Platform in a hands-on way.