From 663a1ec0beb2cf946d4915cd230ea91f43fc7682 Mon Sep 17 00:00:00 2001
From: Jan Krems <jan.krems@groupon.com>
Date: Thu, 6 Apr 2017 09:47:51 -0700
Subject: [PATCH] doc: update information on test/known_issues

* Since https://github.com/nodejs/node/pull/6559 known_issues
  does run on CI.
* Add some notes to explain the expectations around tests in
  known_issues.

PR-URL: https://github.com/nodejs/node/pull/12262
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: Alexey Orlenko <eaglexrlnk@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
---
 test/README.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/test/README.md b/test/README.md
index 0e8c13235da349..3514913f856d1c 100644
--- a/test/README.md
+++ b/test/README.md
@@ -90,8 +90,12 @@ On how to run tests in this direcotry, see
     </tr>
     <tr>
       <td>known_issues</td>
-      <td>No</td>
-      <td>Tests reproducing known issues within the system.</td>
+      <td>Yes</td>
+      <td>
+        Tests reproducing known issues within the system. All tests inside of
+        this directory are expected to fail consistently. If a test doesn't fail
+        on certain platforms, those should be skipped via `known_issues.status`.
+      </td>
     </tr>
     <tr>
       <td>message</td>