From 9f5d0e782d107b71f7a36146eaaad0bf722820cf Mon Sep 17 00:00:00 2001
From: Tasneem Ahmed <163424596+xx-Tasneem-Ahmed-xx@users.noreply.github.com>
Date: Thu, 14 May 2026 17:47:39 +0300
Subject: [PATCH] modular-services: document VM test best practices

added best practices for NixOS VM tests.
---
 nixos/README-modular-services.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/nixos/README-modular-services.md b/nixos/README-modular-services.md
index 82a398f504b4..b068d3628670 100644
--- a/nixos/README-modular-services.md
+++ b/nixos/README-modular-services.md
@@ -43,7 +43,7 @@ When reviewing a modular service, you should check the following. Details and ra
 ### NixOS VM test
 
 See the initial [Modular Services PR](https://github.com/NixOS/nixpkgs/pull/372170) for an [example](https://github.com/NixOS/nixpkgs/pull/372170/files#diff-e7fe16489cf3cd08ecc22b2c7896039d407a329b75691c046c95447423b3153f) of a NixOS VM test.
-TBD: describe best practices here.
+Best practices: keep tests minimal and focused (boot a VM, enable the service, and assert a basic request succeeds). For general guidance, see the [NixOS Tests chapter](https://nixos.org/manual/nixos/unstable/#sec-nixos-tests).
 
 ### `_class = "service"`