From 9692ff55d0dcfd41c61ffd45aa1b5060209a7002 Mon Sep 17 00:00:00 2001
From: Arkadiusz Bokowy <a.bokowy@samsung.com>
Date: Thu, 4 May 2023 16:47:38 +0200
Subject: [PATCH] Document mDNS test cases

---
 src/platform/tests/TestDnssd.cpp | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/platform/tests/TestDnssd.cpp b/src/platform/tests/TestDnssd.cpp
index 52edeec55a92db..b87e4591c8b39a 100644
--- a/src/platform/tests/TestDnssd.cpp
+++ b/src/platform/tests/TestDnssd.cpp
@@ -178,6 +178,13 @@ void TestDnssdBrowse_DnssdInitCallback(void * context, CHIP_ERROR error)
                                    &ctx->mBrowseIdentifier) == CHIP_NO_ERROR);
 }
 
+// Verify that platform DNS-SD implementation can browse and resolve services.
+//
+// This test case uses platform-independent mDNS server implementation based on
+// minimal mdns library. The server is configured to respond to PTR, SRV, TXT,
+// A and AAAA queries without additional records. In order to pass this tests,
+// the platform DNS-SD client implementation must be able to browse and resolve
+// services by querying for all of these record separately.
 void TestDnssdBrowse(nlTestSuite * inSuite, void * inContext)
 {
     DnssdContext context;
@@ -277,6 +284,11 @@ static void TestDnssdPublishService_DnssdInitCallback(void * context, CHIP_ERROR
                                    &ctx->mBrowseIdentifier) == CHIP_NO_ERROR);
 }
 
+// Verify that the platform DNS-SD implementation can publish services.
+//
+// This test uses platform implementation of DNS-SD server and client. Since
+// client implementation should be verified by the TestDnssdBrowse test case,
+// here we only verify that the server implementation can publish services.
 void TestDnssdPublishService(nlTestSuite * inSuite, void * inContext)
 {
     DnssdContext context;