From 4b01f6b1bcfa94ad775f3b0a8ea7476aeb28f024 Mon Sep 17 00:00:00 2001
From: Ilya Kuznetsov <ilya.kuznetsov@databricks.com>
Date: Fri, 10 Jan 2025 18:09:18 +0100
Subject: [PATCH] fix: Add links

---
 bundle/internal/docs/docs.go           |  1 -
 bundle/internal/schema/annotations.yml | 13 +++++--------
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/bundle/internal/docs/docs.go b/bundle/internal/docs/docs.go
index 07979ead0..de32c118f 100644
--- a/bundle/internal/docs/docs.go
+++ b/bundle/internal/docs/docs.go
@@ -180,7 +180,6 @@ func buildAttributeTable(m *md.Markdown, attributes []attributeNode) *md.Markdow
 
 func formatDescription(a attributeNode) string {
 	s := strings.ReplaceAll(a.Description, "\n", " ")
-	return s
 	if a.Reference != "" {
 		if strings.HasSuffix(s, ".") {
 			s += " "
diff --git a/bundle/internal/schema/annotations.yml b/bundle/internal/schema/annotations.yml
index ff9c01749..f7e1aca96 100644
--- a/bundle/internal/schema/annotations.yml
+++ b/bundle/internal/schema/annotations.yml
@@ -57,8 +57,6 @@ github.com/databricks/cli/bundle/config.Deployment:
   "lock":
     "description": |-
       The deployment lock attributes.
-    "markdown_description": |-
-      The deployment lock attributes. See [_](#lock).
 github.com/databricks/cli/bundle/config.Experimental:
   "pydabs":
     "description": |-
@@ -296,8 +294,6 @@ github.com/databricks/cli/bundle/config.Target:
   "artifacts":
     "description": |-
       The artifacts to include in the target deployment.
-    "markdown_description": |-
-      The artifacts to include in the target deployment. See [_](#artifact)
   "bundle":
     "description": |-
       The bundle attributes when deploying to this target.
@@ -335,13 +331,9 @@ github.com/databricks/cli/bundle/config.Target:
   "sync":
     "description": |-
       The local paths to sync to the target workspace when a bundle is run or deployed.
-    "markdown_description": |-
-      The local paths to sync to the target workspace when a bundle is run or deployed. See [_](#sync).
   "variables":
     "description": |-
       The custom variable definitions for the target.
-    "markdown_description": |-
-      The custom variable definitions for the target. See [_](/dev-tools/bundles/variables.md).
   "workspace":
     "description": |-
       The Databricks workspace for the target.
@@ -475,6 +467,11 @@ github.com/databricks/cli/bundle/config/variable.TargetVariable:
     "description": |-
       The type of the variable.
 github.com/databricks/cli/bundle/config/variable.Variable:
+  "_":
+    "description": |-
+      Defines a custom variable for the bundle.
+    "markdown_description": |-
+      Defines a custom variable for the bundle. See [_](/dev-tools/bundles/settings.md#variables).
   "default":
     "description": |-
       PLACEHOLDER