From 7fccc5315bd0537174d8bc7822ce11a9760fa064 Mon Sep 17 00:00:00 2001
From: "Michael Faber (HE/HIM)" <michaelfaber@microsoft.com>
Date: Mon, 10 Jun 2024 16:54:39 -0500
Subject: [PATCH] add title & description to report definition schemas

---
 fabric/item/report/definition/bookmark/1.0.0/schema.json        | 2 ++
 .../item/report/definition/bookmarksMetadata/1.0.0/schema.json  | 2 ++
 .../definition/formattingObjectDefinitions/1.0.0/schema.json    | 2 ++
 fabric/item/report/definition/page/1.0.0/schema.json            | 2 ++
 fabric/item/report/definition/pagesMetadata/1.0.0/schema.json   | 2 ++
 fabric/item/report/definition/report/1.0.0/schema.json          | 2 ++
 fabric/item/report/definition/reportExtension/1.0.0/schema.json | 2 ++
 fabric/item/report/definition/semanticQuery/1.0.0/schema.json   | 2 ++
 fabric/item/report/definition/versionMetadata/1.0.0/schema.json | 2 ++
 fabric/item/report/definition/visualContainer/1.0.0/schema.json | 2 ++
 .../definition/visualContainerMobileState/1.0.0/schema.json     | 2 ++
 11 files changed, 22 insertions(+)

diff --git a/fabric/item/report/definition/bookmark/1.0.0/schema.json b/fabric/item/report/definition/bookmark/1.0.0/schema.json
index e20c6ec..e2dcb02 100644
--- a/fabric/item/report/definition/bookmark/1.0.0/schema.json
+++ b/fabric/item/report/definition/bookmark/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/bookmark/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Bookmark",
+    "description": "Defines a bookmark that captures the state of a report.",
     "type": "object",
     "properties": {
         "displayName": {
diff --git a/fabric/item/report/definition/bookmarksMetadata/1.0.0/schema.json b/fabric/item/report/definition/bookmarksMetadata/1.0.0/schema.json
index a22857d..744d122 100644
--- a/fabric/item/report/definition/bookmarksMetadata/1.0.0/schema.json
+++ b/fabric/item/report/definition/bookmarksMetadata/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/bookmarksMetadata/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Bookmarks metadata",
+    "description": "Defines additional information about standalone bookmarks or groups of related bookmarks.",
     "type": "object",
     "properties": {
         "items": {
diff --git a/fabric/item/report/definition/formattingObjectDefinitions/1.0.0/schema.json b/fabric/item/report/definition/formattingObjectDefinitions/1.0.0/schema.json
index f8accec..baef990 100644
--- a/fabric/item/report/definition/formattingObjectDefinitions/1.0.0/schema.json
+++ b/fabric/item/report/definition/formattingObjectDefinitions/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/formattingObjectDefinitions/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Formatting Object Definitions",
+    "description": "Defines shared definitions for report object formatting.",
     "definitions": {
         "DataViewObjectDefinitions": {
             "type": "object",
diff --git a/fabric/item/report/definition/page/1.0.0/schema.json b/fabric/item/report/definition/page/1.0.0/schema.json
index 3271386..a3c760c 100644
--- a/fabric/item/report/definition/page/1.0.0/schema.json
+++ b/fabric/item/report/definition/page/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/page/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Page",
+    "description": "Defines a single report page.",
     "type": "object",
     "properties": {
         "name": {
diff --git a/fabric/item/report/definition/pagesMetadata/1.0.0/schema.json b/fabric/item/report/definition/pagesMetadata/1.0.0/schema.json
index a968c01..b83aba2 100644
--- a/fabric/item/report/definition/pagesMetadata/1.0.0/schema.json
+++ b/fabric/item/report/definition/pagesMetadata/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/pagesMetadata/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Pages metadata",
+    "description": "Defines additional information about the report's pages.",
     "type": "object",
     "properties": {
         "pageOrder": {
diff --git a/fabric/item/report/definition/report/1.0.0/schema.json b/fabric/item/report/definition/report/1.0.0/schema.json
index 1e6397f..f62696e 100644
--- a/fabric/item/report/definition/report/1.0.0/schema.json
+++ b/fabric/item/report/definition/report/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Report",
+    "description": "Defines a report and its pages, visuals, settings, and additional information.",
     "type": "object",
     "properties": {
         "themeCollection": {
diff --git a/fabric/item/report/definition/reportExtension/1.0.0/schema.json b/fabric/item/report/definition/reportExtension/1.0.0/schema.json
index f2eaaa1..f8a454b 100644
--- a/fabric/item/report/definition/reportExtension/1.0.0/schema.json
+++ b/fabric/item/report/definition/reportExtension/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/reportExtension/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Report extension",
+    "description": "Defines a report extension and its references.",
     "type": "object",
     "properties": {
         "name": {
diff --git a/fabric/item/report/definition/semanticQuery/1.0.0/schema.json b/fabric/item/report/definition/semanticQuery/1.0.0/schema.json
index 67686d7..e195b0e 100644
--- a/fabric/item/report/definition/semanticQuery/1.0.0/schema.json
+++ b/fabric/item/report/definition/semanticQuery/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/semanticQuery/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Semantic Query",
+    "description": "Defines shared definitions for queries and filters.",
     "definitions": {
         "FilterDefinition": {
             "description": "Defines a filter element as a partial query structure",
diff --git a/fabric/item/report/definition/versionMetadata/1.0.0/schema.json b/fabric/item/report/definition/versionMetadata/1.0.0/schema.json
index 7b84b7a..d815e92 100644
--- a/fabric/item/report/definition/versionMetadata/1.0.0/schema.json
+++ b/fabric/item/report/definition/versionMetadata/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/versionMetadata/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Version metadata",
+    "description": "Defines version information about the report definition.",
     "type": "object",
     "properties": {
         "$schema": {
diff --git a/fabric/item/report/definition/visualContainer/1.0.0/schema.json b/fabric/item/report/definition/visualContainer/1.0.0/schema.json
index 8814527..96142d2 100644
--- a/fabric/item/report/definition/visualContainer/1.0.0/schema.json
+++ b/fabric/item/report/definition/visualContainer/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Visual container",
+    "description": "Defines a single visual or visual group on a report page.",
     "type": "object",
     "properties": {
         "name": {
diff --git a/fabric/item/report/definition/visualContainerMobileState/1.0.0/schema.json b/fabric/item/report/definition/visualContainerMobileState/1.0.0/schema.json
index c4a0082..f5d6d1c 100644
--- a/fabric/item/report/definition/visualContainerMobileState/1.0.0/schema.json
+++ b/fabric/item/report/definition/visualContainerMobileState/1.0.0/schema.json
@@ -1,6 +1,8 @@
 {
     "$id": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainerMobileState/1.0.0/schema.json",
     "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "Visual container mobile state",
+    "description": "Defines information about a visual container's mobile layout.",
     "type": "object",
     "properties": {
         "objects": {