From 6e30a825a385d7a3cf294d9e03406221f34b91bc Mon Sep 17 00:00:00 2001
From: Ihar Hrachyshka <ihar.hrachyshka@gmail.com>
Date: Thu, 22 Aug 2024 10:38:13 -0400
Subject: [PATCH] docs: Clarify fullstack local run procedure

First, explain where the repos should be checked out to. Second,
recommend rebooting with the latest distro kernel to avoid ovs module
incompabitilities.

Change-Id: I480ba689a4e20f373e30fe77059474b6dbea5a72
---
 doc/source/contributor/testing/fullstack.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/doc/source/contributor/testing/fullstack.rst b/doc/source/contributor/testing/fullstack.rst
index 7de90d233ed..ca7a2c56aad 100644
--- a/doc/source/contributor/testing/fullstack.rst
+++ b/doc/source/contributor/testing/fullstack.rst
@@ -108,7 +108,15 @@ How to run fullstack tests locally?
 
 Fullstack tests can be run locally. That makes it much easier to understand
 exactly how it works, debug issues in the existing tests or write new ones.
-To run fullstack tests locally, you should clone the following repositories:
+
+Before proceeding, please make sure that the machine runs the latest kernel
+from your distibution repositories (reboot the machine, if needed). Otherwise,
+you may experience issues with the `openvswitch` built from source during the
+environment preparation.
+
+To run fullstack tests locally, you should clone the following repositories
+under `/opt/stack/` directory (you may have to create it first with
+`mkdir -p /opt/stack`):
 
 * `Devstack <https://opendev.org/openstack/devstack/>`
 * `Neutron <https://opendev.org/openstack/neutron>`