Merge pull request #93626 from lpettyjo/OCPBUGS-54478

OCPBUGS-54478#warning for nested mount points

Author: lpettyjo

modules/openshift-storage-common-terms.adoc

@@ -50,6 +50,42 @@ KMS key:: The Key Management Service (KMS) helps you achieve the required level
 
 Local volumes:: A local volume represents a mounted local storage device such as a disk, partition or directory.
 
+Nested mount points:: A nested mount point is a mount point that attempts to use a mount point created by a previous volume.
++
+.Example pod definition with nested mount points
++
+[source,terminal]
+----
+kind: Pod
+apiVersion: v1
+metadata:
+  name: webapp
+  labels:
+    name: webapp
+spec:
+  containers:
+    - name: webapp
+      image: nginx
+      ports:
+        - containerPort: 80
+          name: "http-server"
+      volumeMounts:
+      - mountPath: /mnt/web
+        name: web
+      - mountPath: /mnt/web/redis <1>
+        name: redis
+  volumes:
+    - name: redis
+      persistentVolumeClaim:
+       claimName: "redis"
+    - name: web
+      persistentVolumeClaim:
+        claimName: "web"
+----
+<1> Nested mount point
++
+Do _not_ use nested mount points because {product-title} does not guarantee the order in which mount points are created. Such usage is prone to race conditions and undefined behavior.
+
 ifndef::openshift-dedicated,openshift-rosa[]
 NFS:: A Network File System (NFS) that allows remote hosts to mount file systems over a network and interact with those file systems as though they are mounted locally. This enables system administrators to consolidate resources onto centralized servers on the network.
 endif::openshift-dedicated,openshift-rosa[]