From 1dcba7b7cfe085c513a78a1c2a4f270dd6e2c33b Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Tue, 1 Jun 2021 20:20:46 +0200
Subject: [PATCH] Updated config schema to use Array<> for multiline blocks +
 core wording tweaks

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
---
 packages/core-app-api/config.d.ts | 20 ++++++++++----------
 packages/core/config.d.ts         | 20 ++++++++++----------
 plugins/kafka-backend/config.d.ts |  4 ++--
 3 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/packages/core-app-api/config.d.ts b/packages/core-app-api/config.d.ts
index 9e43c6f3ad..0e1d531226 100644
--- a/packages/core-app-api/config.d.ts
+++ b/packages/core-app-api/config.d.ts
@@ -26,7 +26,7 @@ export interface Config {
     baseUrl: string;
 
     /**
-     * The title of the app.
+     * The title of the app, as shown in the Backstage web interface.
      * @visibility frontend
      */
     title?: string;
@@ -43,7 +43,7 @@ export interface Config {
       /**
        * A list of categorized support item groupings.
        */
-      items: {
+      items: Array<{
         /**
          * The title of the support item grouping.
          * @visibility frontend
@@ -55,15 +55,15 @@ export interface Config {
          */
         icon?: string;
         /**
-         * A list of support links for the Backstage instance.
+         * A list of support links for the Backstage instance inside this grouping.
          */
-        links: {
+        links: Array<{
           /** @visibility frontend */
           url: string;
           /** @visibility frontend */
           title?: string;
-        }[];
-      }[];
+        }>;
+      }>;
     };
   };
 
@@ -72,7 +72,7 @@ export interface Config {
    */
   backend: {
     /**
-     * The public absolute root URL that the backend is reachable at.
+     * The public absolute root URL that the backend is reachable at, from the browser's perspective.
      * @visibility frontend
      */
     baseUrl: string;
@@ -90,16 +90,16 @@ export interface Config {
   };
 
   homepage?: {
-    clocks?: {
+    clocks?: Array<{
       /** @visibility frontend */
       label: string;
       /** @visibility frontend */
       timezone: string;
-    }[];
+    }>;
   };
 
   /**
-   * Configuration that provides information on available authentication providers configured for app
+   * Configuration that provides information on available configured authentication providers.
    */
   auth?: {
     /**
diff --git a/packages/core/config.d.ts b/packages/core/config.d.ts
index 9e43c6f3ad..0e1d531226 100644
--- a/packages/core/config.d.ts
+++ b/packages/core/config.d.ts
@@ -26,7 +26,7 @@ export interface Config {
     baseUrl: string;
 
     /**
-     * The title of the app.
+     * The title of the app, as shown in the Backstage web interface.
      * @visibility frontend
      */
     title?: string;
@@ -43,7 +43,7 @@ export interface Config {
       /**
        * A list of categorized support item groupings.
        */
-      items: {
+      items: Array<{
         /**
          * The title of the support item grouping.
          * @visibility frontend
@@ -55,15 +55,15 @@ export interface Config {
          */
         icon?: string;
         /**
-         * A list of support links for the Backstage instance.
+         * A list of support links for the Backstage instance inside this grouping.
          */
-        links: {
+        links: Array<{
           /** @visibility frontend */
           url: string;
           /** @visibility frontend */
           title?: string;
-        }[];
-      }[];
+        }>;
+      }>;
     };
   };
 
@@ -72,7 +72,7 @@ export interface Config {
    */
   backend: {
     /**
-     * The public absolute root URL that the backend is reachable at.
+     * The public absolute root URL that the backend is reachable at, from the browser's perspective.
      * @visibility frontend
      */
     baseUrl: string;
@@ -90,16 +90,16 @@ export interface Config {
   };
 
   homepage?: {
-    clocks?: {
+    clocks?: Array<{
       /** @visibility frontend */
       label: string;
       /** @visibility frontend */
       timezone: string;
-    }[];
+    }>;
   };
 
   /**
-   * Configuration that provides information on available authentication providers configured for app
+   * Configuration that provides information on available configured authentication providers.
    */
   auth?: {
     /**
diff --git a/plugins/kafka-backend/config.d.ts b/plugins/kafka-backend/config.d.ts
index fbfcd2cb53..04ee74d228 100644
--- a/plugins/kafka-backend/config.d.ts
+++ b/plugins/kafka-backend/config.d.ts
@@ -19,7 +19,7 @@ export interface Config {
      * Client ID used to Backstage uses to identify when connecting to the Kafka cluster.
      */
     clientId: string;
-    clusters: {
+    clusters: Array<{
       name: string;
       /**
        * List of brokers in the Kafka cluster to connect to.
@@ -46,6 +46,6 @@ export interface Config {
         /** @visibility secret */
         password: string;
       };
-    }[];
+    }>;
   };
 }