diff --git a/docs/openshift/pods/health-checks/index.md b/docs/openshift/pods/health-checks/index.md
index f3fde2d..7a62d8f 100644
--- a/docs/openshift/pods/health-checks/index.md
+++ b/docs/openshift/pods/health-checks/index.md
@@ -20,15 +20,47 @@ The kubelet can optionally perform and react to three kinds of probes on running
=== "OpenShift"
- [Application Health :fontawesome-solid-heart-pulse:](https://docs.openshift.com/container-platform/4.14/applications/application-health.html){ .md-button target="_blank"}
+
- [Virtual Machine Health :fontawesome-solid-heart-pulse:](https://docs.openshift.com/container-platform/4.14/virt/logging_events_monitoring/virt-monitoring-vm-health.html){ .md-button target="_blank"}
+ - :fontawesome-solid-heart-pulse:{ .lg .middle } __Application Health__
+
+ ---
+
+ A health check periodically performs diagnostics on a running container using any combination of the readiness, liveness, and startup health checks.
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.14/applications/application-health.html){ target="_blank"}
+
+ - :fontawesome-solid-vr-cardboard:{ .lg .middle } __Virtual Machine Health__
+
+ ---
+
+ Use readiness and liveness probes to detect and handle unhealthy virtual machines (VMs).
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.14/virt/monitoring/virt-monitoring-vm-health.html){ target="_blank"}
+
+
=== "Kubernetes"
- [Container Probes :fontawesome-solid-heart-pulse:](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#container-probes){ .md-button target="_blank"}
+
+
+ - :fontawesome-solid-stethoscope:{ .lg .middle } __Container Probes__
+
+ ---
+
+ To perform a diagnostic, the kubelet either executes code within the container, or makes a network request.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#container-probes){ target="_blank"}
- [Configure Probes :fontawesome-solid-heart-pulse:](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/){ .md-button target="_blank"}
+ - :fontawesome-solid-pen-to-square:{ .lg .middle } __Configure Probes__
+
+ ---
+
+ Read about how to configure liveness, readiness and startup probes for containers.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/){ target="_blank"}
+
+
### References
@@ -80,15 +112,47 @@ Kubernetes provides no native storage solution for log data, but you can integra
=== "OpenShift"
- [Logs Command :fontawesome-solid-file-lines:](https://docs.openshift.com/container-platform/4.13/cli_reference/openshift_cli/developer-cli-commands.html){ .md-button target="_blank"}
+
+
+ - :fontawesome-solid-terminal:{ .lg .middle } __Logs Command__
+
+ ---
+
+ Read about the descriptions and example commands for OpenShift CLI (`oc`) developer commands.
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.13/cli_reference/openshift_cli/developer-cli-commands.html){ target="_blank"}
+
+ - :fontawesome-solid-circle-nodes:{ .lg .middle } __Cluster Logging__
+
+ ---
+
+ As a cluster administrator, you can deploy logging on an OpenShift Container Platform cluster, and use it to collect and aggregate node system audit logs, application container logs, and infrastructure logs.
- [Cluster Logging :fontawesome-solid-file-lines:](https://docs.openshift.com/container-platform/4.13/logging/cluster-logging.html){ .md-button target="_blank"}
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.13/logging/cluster-logging.html){ target="_blank"}
- [Logging Collector :fontawesome-solid-file-lines:](https://docs.openshift.com/container-platform/4.13/logging/config/cluster-logging-collector.html){ .md-button target="_blank"}
+ - :fontawesome-solid-file-lines:{ .lg .middle } __Logging Collector__
+
+ ---
+
+ The collector collects log data from each node, transforms the data, and forwards it to configured outputs.
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.13/observability/logging/cluster-logging.html#logging-architecture-overview_cluster-logging){ target="_blank"}
+
+
=== "Kubernetes"
- [Logging :fontawesome-solid-file-lines:](https://kubernetes.io/docs/concepts/cluster-administration/logging/){ .md-button target="_blank"}
+
+
+ - :fontawesome-solid-file-lines:{ .lg .middle } __Logging__
+
+ ---
+
+ Application logs can help you understand what is happening inside your application and are particularly useful for debugging problems and monitoring cluster activity.
+
+ [:octicons-arrow-right-24: Getting started](https://kubernetes.io/docs/concepts/cluster-administration/logging/){ target="_blank"}
+
+
### References
@@ -141,13 +205,39 @@ Prometheus, a CNCF project, can natively monitor Kubernetes, nodes, and Promethe
=== "OpenShift"
- [Monitoring Application Health :fontawesome-solid-binoculars:](https://docs.openshift.com/container-platform/4.13/applications/application-health.html){ .md-button target="_blank"}
+
+
+ - :fontawesome-solid-binoculars:{ .lg .middle } __Monitoring Application Health__
+
+ ---
+
+ OpenShift Container Platform applications have a number of options to detect and handle unhealthy containers.
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.13/applications/application-health.html){ target="_blank"}
+
+
=== "Kubernetes"
- [Monitoring Resource Usage :fontawesome-solid-binoculars:](https://kubernetes.io/docs/tasks/debug-application-cluster/resource-usage-monitoring/){ .md-button target="_blank"}
+
+
+ - :fontawesome-solid-magnifying-glass:{ .lg .middle } __Monitoring Resource Usage__
+
+ ---
+
+ You can examine application performance in a Kubernetes cluster by examining the containers, pods, services, and the characteristics of the overall cluster.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/tasks/debug-application-cluster/resource-usage-monitoring/){ target="_blank"}
+
+ - :fontawesome-brands-sourcetree:{ .lg .middle } __Resource Metrics__
+
+ ---
+
+ For Kubernetes, the Metrics API offers a basic set of metrics to support automatic scaling and similar use cases.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/tasks/debug-application-cluster/resource-metrics-pipeline/){ target="_blank"}
- [Resource Metrics :fontawesome-solid-binoculars:](https://kubernetes.io/docs/tasks/debug-application-cluster/resource-metrics-pipeline/){ .md-button target="_blank"}
+
### References
diff --git a/docs/openshift/pods/index.md b/docs/openshift/pods/index.md
index 2765854..b881709 100644
--- a/docs/openshift/pods/index.md
+++ b/docs/openshift/pods/index.md
@@ -8,19 +8,63 @@ A Pod encapsulates an application’s container (or, in some cases, multiple con
=== "OpenShift"
- [About Pods :fontawesome-solid-globe:](https://docs.openshift.com/container-platform/4.3/nodes/pods/nodes-pods-using.html){ .md-button target="_blank"}
+
- [Cluster Configuration for Pods :fontawesome-solid-globe:](https://docs.openshift.com/container-platform/4.3/nodes/pods/nodes-pods-configuring.html){ .md-button target="_blank"}
+ - :fontawesome-solid-book:{ .lg .middle } __About Pods__
- [Pod Autoscaling :fontawesome-solid-globe:](https://docs.openshift.com/container-platform/4.3/nodes/pods/nodes-pods-autoscaling.html){ .md-button target="_blank"}
+ ---
+
+ Learn more about the basics of _pods_ and how they work.
+
+ [:octicons-arrow-right-24: Getting started](https://docs.openshift.com/container-platform/4.3/nodes/pods/nodes-pods-using.html){ target="_blank"}
+
+ - :fontawesome-solid-globe:{ .lg .middle } __Cluster Configuration for Pods__
+
+ ---
+
+ Configure your cluster to work for your specific needs.
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.3/nodes/pods/nodes-pods-configuring.html){ target="_blank"}
+
+ - :fontawesome-solid-up-right-and-down-left-from-center:{ .lg .middle } __Pod Autoscaling__
+
+ ---
+
+ Use a horizontal pod autoscaler (HPA) to specify how OCP should automatically scale up or down your deployment.
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.3/nodes/pods/nodes-pods-autoscaling.html){ target="_blank"}
+
+
=== "Kubernetes"
- [Pod Overview :fontawesome-solid-globe:](https://kubernetes.io/docs/concepts/workloads/pods/pod-overview/){ .md-button target="_blank"}
+
+
+ - :fontawesome-solid-book:{ .lg .middle } __Pod Overview__
+
+ ---
+
+ Learn more about the basics of _pods_ and how they work.
+
+ [:octicons-arrow-right-24: Getting started](https://kubernetes.io/docs/concepts/workloads/pods/pod-overview/){ target="_blank"}
+
+ - :fontawesome-solid-arrows-spin:{ .lg .middle } __Pod Lifecycle__
+
+ ---
+
+ Read about the lifecycle process for pods and what each phase means.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/){ target="_blank"}
+
+ - :fontawesome-solid-globe:{ .lg .middle } __Pod Usage__
+
+ ---
+
+ How do you use pods? Read about it here.
- [Pod Lifecycle :fontawesome-solid-globe:](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/){ .md-button target="_blank"}
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/concepts/workloads/pods/pod/){ target="_blank"}
- [Pod Usage :fontawesome-solid-globe:](https://kubernetes.io/docs/concepts/workloads/pods/pod/){ .md-button target="_blank"}
+
## References
diff --git a/docs/openshift/pods/multi-container/index.md b/docs/openshift/pods/multi-container/index.md
index ff885f4..30f0d3c 100644
--- a/docs/openshift/pods/multi-container/index.md
+++ b/docs/openshift/pods/multi-container/index.md
@@ -6,13 +6,41 @@ Container images solve many real-world problems with existing packaging and depl
=== "Kubernetes"
- [Sidecar Logging :fontawesome-solid-boxes-stacked:](https://kubernetes.io/docs/concepts/cluster-administration/logging/#using-a-sidecar-container-with-the-logging-agent){.md-button target="_blank"}
+
- [Shared Volume Communication :fontawesome-solid-boxes-stacked:](https://kubernetes.io/docs/tasks/access-application-cluster/communicate-containers-same-pod-shared-volume/){.md-button target="_blank"}
+ - :fontawesome-solid-file-lines:{ .lg .middle } __Sidecar Logging__
- [Toolkit Patterns :fontawesome-solid-boxes-stacked:](https://kubernetes.io/blog/2015/06/the-distributed-system-toolkit-patterns/){.md-button target="_blank"}
+ ---
- [Brendan Burns Paper :fontawesome-solid-boxes-stacked:](https://static.googleusercontent.com/media/research.google.com/en//pubs/archive/45406.pdf){.md-button target="_blank"}
+ Application logs can help you understand what is happening inside your application.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/concepts/cluster-administration/logging/#using-a-sidecar-container-with-the-logging-agent){ target="_blank"}
+
+ - :fontawesome-solid-circle-nodes:{ .lg .middle } __Shared Volume Communication__
+
+ ---
+
+ Read about how to use a Volume to communicate between two Containers running in the same Pod.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/tasks/access-application-cluster/communicate-containers-same-pod-shared-volume/){ target="_blank"}
+
+ - :fontawesome-solid-blog:{ .lg .middle } __Toolkit Patterns__
+
+ ---
+
+ Read Brendan Burns' blog post about "The Distributed System ToolKit: Patterns for Composite Containers".
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/blog/2015/06/the-distributed-system-toolkit-patterns/){ target="_blank"}
+
+ - :fontawesome-solid-user:{ .lg .middle } __Brendan Burns Paper__
+
+ ---
+
+ Read Brendan Burns' paper about design patterns for container-based distributed systems.
+
+ [:octicons-arrow-right-24: Learn more](https://static.googleusercontent.com/media/research.google.com/en//pubs/archive/45406.pdf){ target="_blank"}
+
+
## References
diff --git a/docs/openshift/pods/tagging/index.md b/docs/openshift/pods/tagging/index.md
index 7b44f5d..ddf6fed 100644
--- a/docs/openshift/pods/tagging/index.md
+++ b/docs/openshift/pods/tagging/index.md
@@ -10,13 +10,39 @@ You can use either labels or annotations to attach metadata to Kubernetes object
=== "OpenShift"
- [CLI Label Commands :fontawesome-solid-tags:](https://docs.openshift.com/container-platform/4.13/cli_reference/openshift_cli/developer-cli-commands.html){.md-button target="_blank"}
+
+
+ - :fontawesome-solid-comment-dots:{ .lg .middle } __CLI Label Commands__
+
+ ---
+
+ Read about the descriptions and example commands for OpenShift CLI (`oc`) developer commands.
+
+ [:octicons-arrow-right-24: Learn more](https://docs.openshift.com/container-platform/4.13/cli_reference/openshift_cli/developer-cli-commands.html){ target="_blank"}
+
+
=== "Kubernetes"
- [Labels :fontawesome-solid-tags:](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/){.md-button target="_blank"}
+
+
+ - :fontawesome-solid-tags:{ .lg .middle } __Labels__
+
+ ---
+
+ Labels can be used to organize and to select subsets of objects.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/){ target="_blank"}
+
+ - :fontawesome-solid-note-sticky:{ .lg .middle } __Annotations__
+
+ ---
+
+ You can use Kubernetes annotations to attach arbitrary non-identifying metadata to objects.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/){ target="_blank"}
- [Annotations :fontawesome-solid-tags:](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/){.md-button target="_blank"}
+
## References
diff --git a/docs/openshift/pods/troubleshooting/index.md b/docs/openshift/pods/troubleshooting/index.md
index be4a314..516c61a 100644
--- a/docs/openshift/pods/troubleshooting/index.md
+++ b/docs/openshift/pods/troubleshooting/index.md
@@ -8,15 +8,47 @@ Usually is getting familiar with how primitives objects interact with each other
=== "OpenShift"
- [Debugging with ODO :fontawesome-solid-bug:](https://odo.dev/docs/user-guides/advanced/debugging-with-openshift-toolkit){.md-button target="_blank"}
+
+
+ - :fontawesome-solid-bug:{ .lg .middle } __Debugging ODO__
+
+ ---
+
+ OpenShift Toolkit is an IDE plugin available on VS Code and JetBrains IDEs, that allows you to do all things that [`odo`](https://odo.dev/docs/introduction){ target="_blank"} does, i.e. create, test, debug and deploy cloud-native applications on a cloud-native environment in simple steps.
+
+ [:octicons-arrow-right-24: Getting started](https://odo.dev/docs/user-guides/advanced/debugging-with-openshift-toolkit){ target="_blank"}
+
+
=== "Kubernetes"
- [Debugging Applications :fontawesome-solid-bug:](https://kubernetes.io/docs/tasks/debug-application-cluster/debug-application/){.md-button target="_blank"}
+
+
+ - :fontawesome-solid-bug:{ .lg .middle } __Debugging Applications__
+
+ ---
+
+ Read about how to debug applications that are deployed into Kubernetes and not behaving correctly.
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/tasks/debug-application-cluster/debug-application/){ target="_blank"}
+
+ - :fontawesome-solid-bug:{ .lg .middle } __Debugging Services__
+
+ ---
+
+ You've run your Pods through a Deployment and created a Service, but you get no response when you try to access it. What do you do?
+
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/tasks/debug-application-cluster/debug-service/){ target="_blank"}
+
+ - :fontawesome-solid-bug:{ .lg .middle } __Debugging Replication Controllers__
+
+ ---
+
+ Read about how to debug replication controllers that are deployed into Kubernetes and not behaving correctly.
- [Debugging Services :fontawesome-solid-bug:](https://kubernetes.io/docs/tasks/debug-application-cluster/debug-service/){.md-button target="_blank"}
+ [:octicons-arrow-right-24: Learn more](https://kubernetes.io/docs/tasks/debug/debug-application/debug-pods/#debugging-replication-controllers){ target="_blank"}
- [Debugging Replication Controllers :fontawesome-solid-bug:](https://kubernetes.io/docs/tasks/debug-application-cluster/debug-pod-replication-controller/){.md-button target="_blank"}
+
## References