fix: Mention that the values of a field of type object are referenceable

in the field's description

Author: fabianrbz

lib/convert_json_schema.rb

@@ -69,6 +69,13 @@ def convert_to_json_schema(props, parent)
       end
     end
 
+    if props['type'] == 'map'
+      if props['values']['referenceable'] && props.key?('description')
+        values_desc = 'The values are [referenceable](/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).'
+        props['description'] = "#{props['description']} #{values_desc}"
+      end
+    end
+
     # Remove required if default is set
     is_required = false unless props['default'].nil?
 
@@ -104,7 +111,6 @@ def convert_to_json_schema(props, parent)
         fields['format'] = 'uuid'
       end
 
-
       if !@options[:skip_custom_annotations]
         if k == 'encrypted'
           note = 'This field is [encrypted](/gateway/keyring/).'