Complete module release documentation

delivery.go

@@ -51,7 +51,8 @@ type DeliveryRequest struct {
 	ModuleDir string
 	Product   string
 	Version   string
-	// ExpectedTag optionally binds delivery to the full tag that triggered a CI event.
+	// ExpectedTag optionally requires the full CI event tag to match the
+	// selected module's derived tag before building or making hosted requests.
 	ExpectedTag string
 	Destination GiteaDestination
 	// Build selects binaries to build in temporary storage outside the checkout.
@@ -70,8 +71,8 @@ type DeliveryResult struct {
 	RepositoryDir   string
 	ModuleDir       string
 	ModulePath      string
-	Tag             string
-	Version         string
+	Tag             string // complete derived Git tag.
+	Version         string // selected stable semantic version.
 	CandidateCommit string
 	ReleaseURL      string
 	State           DeliveryState