From be3cfab4d8a9a6c55ab2df94a618f4deb85b9515 Mon Sep 17 00:00:00 2001
From: Jeroen Op 't Eynde <jeroen@simplistic.be>
Date: Mon, 24 Oct 2022 09:12:44 +0200
Subject: [PATCH] fix(doc-util): print info message when docstring can't get
 parsed (#33)

---
 doc-util/render.libsonnet | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/doc-util/render.libsonnet b/doc-util/render.libsonnet
index a03c572..69e57ad 100644
--- a/doc-util/render.libsonnet
+++ b/doc-util/render.libsonnet
@@ -244,11 +244,20 @@
           (depth == 0)
         )
 
+
         // Field definition
         else if std.startsWith(key, '#')
         then (
           local realKey = key[1:];
-          if 'value' in obj[key]
+
+          if !std.isObject(obj[key])
+          then
+            std.trace(
+              'INFO: docstring "%s" cannot be parsed, ignored while rendering.' % key,
+              {}
+            )
+
+          else if 'value' in obj[key]
           then {
             values+: [root.sections.value(
               key,
@@ -272,7 +281,11 @@
               depth
             )],
           }
-          else {}
+          else
+            std.trace(
+              'INFO: docstring "%s" cannot be parsed, ignored while rendering.' % key,
+              {}
+            )
         )
 
         // subPackage definition