From 222e2ff1c6691b82f7aed87cac47d59dcb564e21 Mon Sep 17 00:00:00 2001
From: Krzysztof Klimonda <kklimonda@paloaltonetworks.com>
Date: Tue, 24 Sep 2024 14:00:04 +0200
Subject: [PATCH] Add resource-level description to specifications

Closes: #159
---
 pkg/properties/normalized.go    | 2 ++
 pkg/schema/object/object.go     | 1 +
 specs/schema/object.schema.json | 1 +
 3 files changed, 4 insertions(+)

diff --git a/pkg/properties/normalized.go b/pkg/properties/normalized.go
index 8f83eaf8..911d4168 100644
--- a/pkg/properties/normalized.go
+++ b/pkg/properties/normalized.go
@@ -65,6 +65,7 @@ const (
 )
 
 type TerraformProviderConfig struct {
+	Description           string                     `json:"description" yaml:"description"`
 	SkipResource          bool                       `json:"skip_resource" yaml:"skip_resource"`
 	SkipDatasource        bool                       `json:"skip_datasource" yaml:"skip_datasource"`
 	SkipDatasourceListing bool                       `json:"skip_datasource_listing" yaml:"skip_datasource_listing"`
@@ -528,6 +529,7 @@ func schemaToSpec(object object.Object) (*Normalization, error) {
 	spec := &Normalization{
 		Name: object.DisplayName,
 		TerraformProviderConfig: TerraformProviderConfig{
+			Description:           object.TerraformConfig.Description,
 			SkipResource:          object.TerraformConfig.SkipResource,
 			SkipDatasource:        object.TerraformConfig.SkipDatasource,
 			SkipDatasourceListing: object.TerraformConfig.SkipdatasourceListing,
diff --git a/pkg/schema/object/object.go b/pkg/schema/object/object.go
index 26da00d3..398934a1 100644
--- a/pkg/schema/object/object.go
+++ b/pkg/schema/object/object.go
@@ -26,6 +26,7 @@ const (
 )
 
 type TerraformConfig struct {
+	Description           string                     `yaml:"description"`
 	SkipResource          bool                       `yaml:"skip_resource"`
 	SkipDatasource        bool                       `yaml:"skip_datasource"`
 	SkipdatasourceListing bool                       `yaml:"skip_datasource_listing"`
diff --git a/specs/schema/object.schema.json b/specs/schema/object.schema.json
index 484ff98a..0666612e 100644
--- a/specs/schema/object.schema.json
+++ b/specs/schema/object.schema.json
@@ -20,6 +20,7 @@
       "additionalProperties": false,
       "required": ["suffix"],
       "properties": {
+        "description": { "type": "string" },
         "resource_type": {
           "type": "string",
           "enum": ["entry", "config", "uuid", "custom"]