Document NewMacro() properly

Author: EdSchouten

pkg/model/starlark/macro.go

@@ -17,6 +17,8 @@ type macro[TReference object.BasicReference, TMetadata model_core.ReferenceMetad
 
 var _ EncodableValue[object.LocalReference, model_core.ReferenceMetadata] = (*macro[object.LocalReference, model_core.ReferenceMetadata])(nil)
 
+// NewMacro creates a Starlark macro object. These are normally created
+// using the macro() function.
 func NewMacro[TReference object.BasicReference, TMetadata model_core.ReferenceMetadata]() starlark.Value {
 	return macro[TReference, TMetadata]{}
 }

pkg/model/starlark/rule.go

@@ -29,7 +29,8 @@ var (
 	_ NamedGlobal                                                         = (*rule[object.LocalReference, model_core.ReferenceMetadata])(nil)
 )
 
-// NewRule creates a Starlark rule object.
+// NewRule creates a Starlark rule object. These are normally created
+// using the rule() function.
 func NewRule[TReference object.BasicReference, TMetadata model_core.ReferenceMetadata](identifier *pg_label.CanonicalStarlarkIdentifier, definition RuleDefinition[TReference, TMetadata]) starlark.Value {
 	return &rule[TReference, TMetadata]{
 		LateNamedValue: LateNamedValue{