From 4703e1e3a2d6c64d56cd9197ea14ea4150eae692 Mon Sep 17 00:00:00 2001
From: Anushree-Mathur2 <anushree.mathur@linux.ibm.com>
Date: Fri, 18 Sep 2026 14:14:14 +0530
Subject: [PATCH] docs: document minor version-specific package dependencies in
 README

Currently, bootstrap only supports major version package definitions.
This prevents handling packages that exist only in specific minor
versions of an OS.

This commit adds documentation for the minor version support by:
- Explaining how the wrapper checks minor version-specific sections
  first (e.g., [deps_sles16_1]) before falling back to the major
  version section (e.g., [deps_sles16])
- Documenting the same fallback logic for environment-type packages
  (e.g., [deps_sles16_1_kvm] -> [deps_sles16_kvm])
- Providing a clear example config usage in config/wrapper/env.conf
- Highlighting that packages in [deps_sles16_1] are pre-requisite
  packages only for SLES 16.1 and will not affect other SLES 16.x
  versions

Signed-off-by: Anushree-Mathur <anushree.mathur@linux.ibm.com>
---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index dcd20fb1..f7e28e0c 100644
--- a/README.md
+++ b/README.md
@@ -295,6 +295,28 @@ $ ./avocado-setup.py -h
     > correctly identify which suites ran, which was interrupted, and which never started.
     > Works for both host and guest test suites.
 
+### Minor Version-Specific Package Dependencies:
+
+  By default, the wrapper checks for OS-level dependency packages using the **major version** of the detected OS
+  (e.g., `[deps_sles16]`). The wrapper also supports **minor version-specific** sections that take priority over
+  the major version section.
+
+  **How it works:**
+  1. The wrapper first checks for a minor version-specific section (e.g., `[deps_sles16_1]`)
+  2. If not found, it falls back to the major version section (e.g., `[deps_sles16]`)
+  3. The same lookup logic applies to environment-type packages (e.g., `[deps_sles16_1_kvm]` → `[deps_sles16_kvm]`)
+
+  **Example** — add packages only for SLES 16.1 in `config/wrapper/env.conf`:
+  ```
+  [deps_sles16]
+  packages = gcc,python311-devel,xz-devel
+
+  [deps_sles16_1]
+  packages = version-specific-package
+  ```
+
+  > **Note:** Packages in `[deps_sles16_1]` will **only** be the pre-requisite packages that need to be installed on SLES 16.1 and will not affect other SLES 16.x versions.
+
 ### Customizing Test Suites:
 
   The Host and Guest sanity suites were created to include a varied collection of tests to validate new Host OS installations.