[DOCS] Present EMT Usage Scenarios in tabs (open-edge-platform#715)

* [DOCS] Present EMT usage scenarios in tabs

* Update usage scenarios

* Update menu and references

Author: sgolebiewski-intel

docs/developer-guide/architecture/emt-extensions-and-patches.md

@@ -1,4 +1,4 @@
-# Extensions And Patches
+# Extensions and Patches
 
 Edge Microvisor Toolkit leverages a collection of extensions and patches
 to provide more versatile deployment options and optimizations for Intel® silicon based AI
@@ -11,46 +11,56 @@ Deploying of Edge Microvisor Toolkit with Lightweight Kubernetes (K3s)
 requires additional extensions which are downloaded as docker images. Below is
 a list of components essential for scaled deployment of the toolkit.
 
-### [Multus CNI](https://github.com/k8snetworkplumbingwg/multus-cni)
+### Multus CNI
 
 A Container Network Interface (CNI) plugin for Kubernetes that enables you to
 attach multiple network interfaces to Kubernetes pods, which usually have only
-one network interface.
+one network interface. For more details, refer to the
+[GitHub page](https://github.com/k8snetworkplumbingwg/multus-cni).
 
-### [Intel Device Plugins for Kubernetes](https://github.com/intel/intel-device-plugins-for-kubernetes)
-
-[GPU Plugin](https://github.com/intel/intel-device-plugins-for-kubernetes/blob/main/cmd/gpu_plugin/README.md)
+### Intel Device Plugins for Kubernetes
 
 Intel GPU plugin provides access to discrete and integrated Intel GPU devices
 supported by the host kernel. It enables offloading compute operations of
 Kubernetes workload to GPU devices. It may be beneficial in such use cases as
 media transcoding and analytics, cloud gaming, AI training and inference.
+For more details, refer to the
+[GitHub page](https://github.com/intel/intel-device-plugins-for-kubernetes/blob/main/cmd/gpu_plugin/README.md).
 
-### [Calico](https://github.com/projectcalico/calico)
+### Calico
 
-- [CNI Plugin](https://github.com/projectcalico/calico/tree/master/cni-plugin)
-\- as [docker image](https://hub.docker.com/r/calico/cni).
+- **CNI Plugin**
 
-  A plugin that enables you to use Calico for deployments based on Container
-  Network Interface (CNI).
+  [A plugin](https://github.com/projectcalico/calico/tree/master/cni-plugin)
+  that enables you to use Calico for deployments based on Container
+  Network Interface (CNI). It is available as a
+  [docker image](https://hub.docker.com/r/calico/cni).
 
-- [Node](https://github.com/projectcalico/calico/tree/master/node)
-  \- as [docker image](https://hub.docker.com/r/calico/node/).
+- **Node**
 
-  A CNI plugin that enables you to create a Layer 3 network for Kubernetes
-  pods and assign a unique IP address for each.
+  [A CNI plugin](https://github.com/projectcalico/calico/tree/master/node)
+  that enables you to create a Layer 3 network for Kubernetes
+  pods and assign a unique IP address for each. Node is available as a
+  [docker image](https://hub.docker.com/r/calico/node/)
 
-- [Kube controllers](https://github.com/projectcalico/calico/tree/master/kube-controllers)
-  \- as [docker image](https://hub.docker.com/r/calico/kube-controllers).
+- **Kube controllers**
 
-  A set of controllers that monitor the resources in the Kubernetes API (network,
-  policies, nodes) and adjust Calico's CNI configuration.
+  [A set of controllers](https://github.com/projectcalico/calico/tree/master/kube-controllers)
+  that monitor the resources in the Kubernetes API (network,
+  policies, nodes) and adjust Calico's CNI configuration. Kube controllers are
+  available as a [docker image](https://hub.docker.com/r/calico/kube-controllers).
 
 
 ## Patches
 
-Below are listed quilt patchsets that include
-[Intel not-upstreamed kernel features](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/SPECS/kernel/kernel.spec).
+Below is a list of
+[Intel not-upstreamed kernel features](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/SPECS/kernel/kernel.spec).\
+Check the following quilt patchsets:
+
+- [PREEMPT_RT](#preempt_rt)
+- [Time-Sensitive Networking (TSN)](#time-sensitive-networking-tsn)
+- [SR-IOV](#sr-iov)
+- [DRM](#drm)
 
 ### PREEMPT_RT
 

docs/developer-guide/emt-architecture-overview.md

@@ -455,10 +455,10 @@ for deployment instructions and full source code.
 
 ## Time-Sensitive Networking support
 
-EMT supports time-sensitive networking through custom patches and optimizations in
+Edge Microvisor Toolkit supports time-sensitive networking through custom patches and optimizations in
+[the kernel](./architecture/emt-extensions-and-patches.md#time-sensitive-networking-tsn), the
 [linuxptp](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/SPECS/linuxptp/linuxptp.spec), [ethtool](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/SPECS/ethtool/ethtool.spec)
-and [xdp-tools](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/SPECS/xdp-tools/xdp-tools.spec). Click on any of the names to go to
-their SPEC files and learn about specific patches related to TSN optimizations.
+and [xdp-tools](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/SPECS/xdp-tools/xdp-tools.spec) packages.
 
 <!--hide_directive
 :::{toctree}

docs/developer-guide/emt-bootkit.md

@@ -1,6 +1,8 @@
-:::
-orphan: true
-:::
+<!--hide_directive
+```{eval-rst}
+:orphan:
+```
+hide_directive-->
 
 # Edge Microvisor Bootkit
 
@@ -18,7 +20,7 @@ the resulting image are defined in [edge-image-bootkit.json](https://github.com/
 as well as
 [Bootkit specific packages](https://github.com/open-edge-platform/edge-microvisor-toolkit/blob/3.0/toolkit/imageconfigs/packagelists/bootkit-packages.json).
 
-Before you can build the image, make sure you have [installed prerequisites and built the toolchain](./get-started/emt-building-howto.md).
+Before you can build the image, make sure you have [installed prerequisites and built the toolchain](../get-started/emt-building-howto.md).
 To build the Bootkit OS image, run the following command:
 
 ```bash

docs/developer-guide/emt-contribution.md

@@ -1,4 +1,4 @@
-# Edge Microvisor Toolkit Contribution Guide
+# Contribution Guide
 
 Edge Microvisor Toolkit is open source and always welcomes an active
 community to support adding new features, optimizing, and improving security.

docs/developer-guide/emt-get-started.md

@@ -37,8 +37,9 @@ including remote deployment and management of applications orchestrated by Kuber
 :hidden:
 
 ./get-started/emt-versions.md
+./get-started/emt-installation-howto.md
 ./get-started/emt-building-howto.md
 ./get-started/emt-build-and-deploy.md
-./get-started/emt-installation-howto.md
+
 :::
 hide_directive-->

docs/developer-guide/emt-security-considerations.md

@@ -1,4 +1,4 @@
-# Edge Microvisor Toolkit Security Considerations
+# Security Considerations
 
 ## EMT Security Overview
 

docs/developer-guide/emt-troubleshooting.md

@@ -1,4 +1,4 @@
-# Edge Microvisor Toolkit Troubleshooting
+# Troubleshooting
 
 This section provides additional tips and suggestions for common questions
 and issues users may run into.

docs/developer-guide/emt-tutorials.md

@@ -1,16 +1,19 @@
 # Tutorials
 
-This section contains tutorials for common tasks, including customization
-of a mutable developer node:
+This section contains tutorials for common tasks, including deployment and customization
+of the toolkit:
 
+- Learn how to [Deploy Edge Microvisor Toolkit with Edge Orchestrator](./tutorials/emt-deployment-edge-orchestrator.md).
 - Learn how to [Enable Debugging with GDB in Edge Microvisor Toolkit Developer Node](./tutorials/emt-gdb-debugging.md).
 - Learn how to [Enable X11 Desktop UI for Edge Microvisor Toolkit Developer Node](./tutorials/emt-x11-desktop-ui.md).
 
 <!--hide_directive
 :::{toctree}
 :hidden:
 
-./tutorials/emt-gdb-debugging.md
-./tutorials/emt-x11-desktop-ui.md
+./tutorials/emt-deployment-edge-orchestrator
+./tutorials/emt-gdb-debugging
+./tutorials/emt-x11-desktop-ui
+
 :::
-hide_directive-->
+hide_directive-->

docs/developer-guide/get-started/emt-versions.md

@@ -15,16 +15,101 @@ suits your needs. To do so, check out:
 |--------|---------|-------------|------|
 | [**Standalone (Immutable)**](https://github.com/open-edge-platform/edge-microvisor-toolkit-standalone-node) | Available for opt-in | ✓ | ✓ |
 | [**Developer Node (Mutable)**](../emt-architecture-overview.md#developer-node-mutable-iso-image) | Optional | ✓ | ✓ |
-| [**EMT for EMF**](../emt-deployment-edge-orchestrator.md) | Available for opt-in | ✓ | ✓ |
+| [**EMT for EMF**](../tutorials/emt-deployment-edge-orchestrator.md) | Available for opt-in | ✓ | ✓ |
 | [**Bootkit**](../emt-bootkit.md) | - | ✓ | – |
 
 ## How usage scenarios affect EMT setup
 
-| Scenario | Description | Primary outcomes | Technology areas | Kernel patchset (quilts) |
-|---|---|---|---|---|
-| Real-time & deterministic workloads | Run latency-sensitive workloads with guaranteed bounded jitter and repeatable execution timelines across one or more hosts, maintainable under steady-state and failure-recovery conditions | <br> - Bounded end-to-end latency & jitter <br> - Repeatable scheduling windows under load <br> - Cross-host timing consistency for distributed stages <br> - Fast, predictable recovery without violating SLOs | <br> - [PREEMPT_RT kernel](../emt-architecture-overview.md#preempt-rt-kernel) <br> - [Resource Director Technologies](../emt-architecture-overview.md#resource-director-technology) <br> - [Intel GPU RT](../emt-architecture-overview.md#intel-device-plugins-for-kubernetes) <br> - [CPU & Scheduler Isolation](../emt-architecture-overview.md#isolcpuslist) <br> - [Memory Determinism](../emt-architecture-overview.md#preempt-rt-kernel) <br> - Time & Clocks <br> - [Network Determinism (TSN)](../emt-architecture-overview.md#time-sensitive-networking-support) | - [PREEMPT_RT](../architecture/emt-extensions-and-patches.md#preempt_rt) <br> - [Time-Sensitive Networking](../architecture/emt-extensions-and-patches.md#time-sensitive-networking-tsn) |
-| VM-based workloads on Kubernetes with shared GPUs | Run multiple virtual machines on Kubernetes that concurrently share one or more physical GPUs, with predictable fairness, isolation, and policy-driven placement—using a KubeVirt stack extended for GPU sharing | <br> - Stable, repeatable GPU performance per VM under contention <br> - Hard/soft sharing policies (fair-share, priority tiers, or quotas) <br> - Safe isolation between tenants/VMs (memory, contexts, resets) <br> - Schedulable resources with clear admission signals (no surprise fails) <br> - Operational guardrails: health checks, graceful drain/eviction, rollback | <br> - [SRIOV](./deployment/emt-vm-host.md) <br> - [Intel GPU](../emt-system-requirements.md#discrete-gpu) <br> - [kubevirt](https://github.com/open-edge-platform/edge-microvisor-toolkit-standalone-node/blob/main/standalone-node/docs/user-guide/desktop-virtualization-image-guide.md) <br> - [Host virtualization](./deployment/emt-vm-host.md) <br> - [Intel GPU device plugin](../emt-architecture-overview.md#intel-device-plugins-for-kubernetes) | - [SR-IOV](../architecture/emt-extensions-and-patches.md#sr-iov) <br> - [DRM](../architecture/emt-extensions-and-patches.md#drm)    |
-| AI & Vision workloads | Enable AI inference and computer-vision workloads on edge nodes using Intel GPU and NPU acceleration, exposing unified hardware-assisted pipelines through standard APIs and user-space libraries | <br> - Efficient execution of deep-learning and vision inference on-device without cloud dependency <br> - Unified GPU/NPU compute abstraction for developers (OpenVINO backend, media pipelines) <br> - Deterministic frame-rate and latency for multi-stream analytics workloads (e.g., camera ingest) <br> - Seamless integration with containers or pods, including dynamic device discovery and sharing <br> - Stable ABI/API interface across [OS updates](../architecture/emt-updates.md) and driver versions | <br> - [Edge AI packages](https://eci.intel.com/docs/3.3/packages_list.html) <br> - [OpenVino](https://docs.openvino.ai) <br> - [Intel GPU and NPU drivers](https://docs.openvino.ai/2025/openvino-workflow/running-inference/inference-devices-and-modes.html) <br> - [Intel GPU device plugin](../emt-architecture-overview.md#intel-device-plugins-for-kubernetes) |  |
+<!--hide_directive::::{tab-set}
+:::{tab-item}hide_directive--> Real Time & Deterministic
+<!--hide_directive:sync: tab1hide_directive-->
+\
+Run latency-sensitive workloads with guaranteed bounded jitter and repeatable
+execution timelines across one or more hosts, maintainable under steady-state
+and failure-recovery conditions.
+
+*Primary outcomes:*
+
+- Bounded end-to-end latency & jitter
+- Repeatable scheduling windows under load
+- Cross-host timing consistency for distributed stages
+- Fast, predictable recovery without violating SLOs
+
+*Technology areas:*
+
+- [PREEMPT_RT kernel](../emt-architecture-overview.md#preempt-rt-kernel)
+- [Resource Director Technologies](../emt-architecture-overview.md#resource-director-technology)
+- [Intel GPU RT](../emt-architecture-overview.md#intel-device-plugins-for-kubernetes)
+- [CPU & Scheduler Isolation](../emt-architecture-overview.md#isolcpuslist)
+- [Memory Determinism](../emt-architecture-overview.md#preempt-rt-kernel)
+- [Network Determinism (TSN)](../emt-architecture-overview.md#time-sensitive-networking-support)
+- Time & Clocks
+
+*Kernel patchsets (quilts):*
+
+- [PREEMPT_RT](../architecture/emt-extensions-and-patches.md#preempt_rt)
+- [Time-Sensitive Networking](../architecture/emt-extensions-and-patches.md#time-sensitive-networking-tsn)
+
+<!--hide_directive:::
+:::{tab-item}hide_directive--> Virtual Machines (Kubernetes, shared GPUs)
+<!--hide_directive:sync: tab2hide_directive-->
+\
+Run multiple virtual machines on Kubernetes that concurrently share one or more
+physical GPUs, with predictable fairness, isolation, and policy-driven placement—using
+a KubeVirt stack extended for GPU sharing.
+
+*Primary outcomes:*
+
+- Stable, repeatable GPU performance per VM under contention
+- Hard/soft sharing policies (fair-share, priority tiers, or quotas)
+- Safe isolation between tenants/VMs (memory, contexts, resets)
+- Schedulable resources with clear admission signals (no surprise fails)
+- Operational guardrails: health checks, graceful drain/eviction, rollback
+
+*Technology areas:*
+
+- [SRIOV](./deployment/emt-vm-host.md)
+- [Intel GPU](../emt-system-requirements.md#discrete-gpu)
+- [kubevirt](https://github.com/open-edge-platform/edge-microvisor-toolkit-standalone-node/blob/main/standalone-node/docs/user-guide/desktop-virtualization-image-guide.md)
+- [Host virtualization](./deployment/emt-vm-host.md)
+- [Intel GPU device plugin](../emt-architecture-overview.md#intel-device-plugins-for-kubernetes)
+
+*Kernel patchsets (quilts):*
+
+- [SR-IOV](../architecture/emt-extensions-and-patches.md#sr-iov)
+- [DRM](../architecture/emt-extensions-and-patches.md#drm) 
+
+
+<!--hide_directive:::
+:::{tab-item}hide_directive--> AI & Vision Systems
+<!--hide_directive:sync: tab3hide_directive-->
+\
+Enable AI inference and computer-vision workloads on edge nodes using Intel GPU
+and NPU acceleration, exposing unified hardware-assisted pipelines through
+standard APIs and user-space libraries.
+
+**Primary outcomes:**
+
+- Efficient execution of deep-learning and vision inference on-device without
+  cloud dependency
+- Unified GPU/NPU compute abstraction for developers (OpenVINO backend,
+  media pipelines)
+- Deterministic frame-rate and latency for multi-stream analytics workloads
+  (e.g., camera ingest)
+- Seamless integration with containers or pods, including dynamic device
+  discovery and sharing
+- Stable ABI/API interface across [OS updates](../architecture/emt-updates.md)
+  and driver versions
+
+**Technology areas:**
+
+- [Edge AI packages](https://eci.intel.com/docs/3.3/packages_list.html)
+- [OpenVino](https://docs.openvino.ai)
+- [Intel GPU and NPU drivers](https://docs.openvino.ai/2025/openvino-workflow/running-inference/inference-devices-and-modes.html)
+- [Intel GPU device plugin](../emt-architecture-overview.md#intel-device-plugins-for-kubernetes)
+
+<!--hide_directive:::
+::::hide_directive-->
 
 ## How to build your own version of EMT
 

docs/developer-guide/index.md

@@ -15,7 +15,7 @@ different use cases demonstrating how Intel processors can cost-effectively mini
 To select the right version for you, follow the article on
 [Edge Microvisor Toolkit Versions](./get-started/emt-versions.md).
 
-For an immediate hands-on experience with no limitations, download the 
+For an immediate hands-on experience with no limitations, download the
 [Developer Node ISO](https://files-rs.edgeorchestration.intel.com/files-edge-orch/microvisor/iso/EdgeMicrovisorToolkit-3.1.iso) and
 [install on a virtual machine](https://docs.openedgeplatform.intel.com/2025.2/edge-microvisor-toolkit/get-started/deployment/emt-vm-guest.html).
 
@@ -70,12 +70,11 @@ document.
 
 emt-get-started
 emt-architecture-overview
-emt-deployment-edge-orchestrator
-emt-bootkit
+emt-tutorials
 emt-security-considerations
 emt-contribution
 emt-troubleshooting
 emt-system-requirements
-emt-tutorials
+
 :::
 hide_directive-->