From 3b3e9e57d6cbd297079fbe4436e070e8a6aa7180 Mon Sep 17 00:00:00 2001
From: Milos Prchlik <mprchlik@redhat.com>
Date: Feb 13 2019 16:29:11 +0000
Subject: Better description of run.log_stream


---

diff --git a/schemas/run.yaml b/schemas/run.yaml
index d92d834..f9d6dbe 100644
--- a/schemas/run.yaml
+++ b/schemas/run.yaml
@@ -27,6 +27,12 @@ properties:
     log_stream:
         description:
             URL of a plain-text build log, which can be followed for progress.
+
+            Serves different goal than log_raw - while these two may share the value,
+            it is also quite possible that log_raw would point to some external (cold)
+            storage, making it unsuitable for streaming the output. They also disagree
+            on the time when they are valid - log_raw is supposed to be valid as long
+            as log while log_stream makes sense only when the testing process is running.
         examples:
             - https://somewhere.com/job/ci-openstack/4794/consoleText
         type: string