diff --git a/roles/fetch-output/README.rst b/roles/fetch-output/README.rst
index 9f59a00ca..812cd94d6 100644
--- a/roles/fetch-output/README.rst
+++ b/roles/fetch-output/README.rst
@@ -5,6 +5,14 @@ This role collects logs, artifacts and docs from subdirs of the
 on the executor so that later parts of the system can publish the
 content to appropriate permanent locations.
 
+.. note::
+
+  Log content for multi-node jobs will be put into subdirectories
+  based on remote node name. It is expected that artifacts and docs
+  produced be inherently unique regardless of which build node they
+  were produced on, so all artifacts and docs are pulled back to
+  the same artifacts and docs directory.
+
 **Role Variables**
 
 .. zuul:rolevar:: zuul_output_dir