From 7310b0feda65962b689d2db72382d9fda5f231e4 Mon Sep 17 00:00:00 2001
From: William Ballenthin <william.ballenthin@fireeye.com>
Date: Mon, 31 Aug 2020 16:55:54 -0600
Subject: [PATCH] rules: documentation formatting

---
 capa/rules.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/capa/rules.py b/capa/rules.py
index 55ce2014..81df0c80 100644
--- a/capa/rules.py
+++ b/capa/rules.py
@@ -631,7 +631,13 @@ class Rule(object):
         #       - string: foo
         #         description: bar
         #
-        # we want the `description` horizontally aligned with the start of the `string`.
+        # we want the `description` horizontally aligned with the start of the `string` (like above).
+        # however, ruamel will give us (which I don't think is even valid yaml):
+        #
+        #     and:
+        #       - string: foo
+        #      description: bar
+        #
         # tweaking `ruamel.indent()` doesn't quite give us the control we want.
         # so, add the two extra spaces that we've determined we need through experimentation.
         # see #263