diff --git a/bundle/internal/schema/main.go b/bundle/internal/schema/main.go
index c35caf1d9..e9d0f4dc0 100644
--- a/bundle/internal/schema/main.go
+++ b/bundle/internal/schema/main.go
@@ -27,7 +27,6 @@ func addInterpolationPatterns(typ reflect.Type, s jsonschema.Schema) jsonschema.
 		return jsonschema.Schema{
 			AnyOf: []jsonschema.Schema{s, {
 				Type: jsonschema.StringType,
-				// TODO: Are multi-level complex variable references supported?
 				Pattern: interpolationPattern("var"),
 			}},
 		}
@@ -36,7 +35,6 @@ func addInterpolationPatterns(typ reflect.Type, s jsonschema.Schema) jsonschema.
 		// or ${workspace.xyz}
 		return jsonschema.Schema{
 			AnyOf: []jsonschema.Schema{s,
-				// TODO: Is it only resource IDs or is it resources in general?
 				{Type: jsonschema.StringType, Pattern: interpolationPattern("resources")},
 				{Type: jsonschema.StringType, Pattern: interpolationPattern("bundle")},
 				{Type: jsonschema.StringType, Pattern: interpolationPattern("workspace")},
diff --git a/libs/jsonschema/schema.go b/libs/jsonschema/schema.go
index b364c8276..aaa075ed6 100644
--- a/libs/jsonschema/schema.go
+++ b/libs/jsonschema/schema.go
@@ -13,7 +13,8 @@ import (
 
 // defines schema for a json object
 type Schema struct {
-	// TODO: Comments for this field
+	// Definitions that can be reused and referenced throughout the schema. The
+	// syntax for a reference is $ref: #/$defs/<path.to.definition>
 	Definitions any `json:"$defs,omitempty"`
 
 	// Type of the object