From 8e323fbd9a6cc786f9e23820696c678e07a1a789 Mon Sep 17 00:00:00 2001
From: Monty Taylor <mordred@inaugust.com>
Date: Sun, 6 Jan 2019 17:13:21 +0000
Subject: [PATCH] Add note about multi-node jobs

artifacts and docs are expected to be unique regardless of host, unlike
logs. Add a note to the README.

Change-Id: Ie66500c3e1d18147a6d86c46a6dbe9642c9fb515
---
 roles/fetch-output/README.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

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