From 369c8dc388caad0d4fa7e9da15a3a0cd62cd3b39 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ond=C5=99ej=20Sur=C3=BD?= Date: Thu, 28 Aug 2025 11:40:37 +0200 Subject: [PATCH] Clarify rrset-order random distribution The randomized order of the records in the rrset is not uniform across all permutations. Clarify this in the documentation. --- doc/arm/reference.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/arm/reference.rst b/doc/arm/reference.rst index f79eb59520..b41429d1d4 100644 --- a/doc/arm/reference.rst +++ b/doc/arm/reference.rst @@ -4050,7 +4050,8 @@ RRset Ordering The legal values for ```` are: ``random`` - Records are returned in a random order. + Records are returned in a non-deterministic order. The random ordering + doesn't guarantee uniform distribution of all permutations. ``cyclic`` Records are returned in a cyclic round-robin order, rotating by one