another attempt

internal/config/types.go

@@ -15,10 +15,11 @@ type KforgeConfig struct {
 	Preview        PreviewConfig                `yaml:"preview,omitempty"`
 	Environments   map[string]EnvironmentConfig `yaml:"environments"`
 
-	// ActionRef is the Gitea Actions reference to this kforge installation
-	// (e.g. "gitea.example.com/infra/kforge@main"). When set, kforge gitea-actions
-	// and kforge gitea-preview generate workflows that call kforge as a reusable
-	// action step instead of installing and running kforge inline.
+	// ActionRef is the Docker image reference for the pre-built kforge action
+	// (e.g. "registry.example.com/infra/kforge:latest"). When set, kforge
+	// gitea-actions and kforge gitea-preview generate `uses: docker://<ref>`
+	// steps instead of installing and running kforge inline. The kforge repo
+	// must publish this image on each release.
 	ActionRef string `yaml:"action_ref,omitempty"`
 }