Expose Markdown validation selection

publish.go

@@ -54,9 +54,14 @@ type PublicationResult struct {
 // Validation.Go.FullVet runs go vet afterward instead of test-time vet, and
 // Validation.Go.CompileTargets compiles all packages for each selected target
 // with cgo disabled after tests and vet. Compilation produces no artifacts and
-// does not execute target binaries. ExpectedPushURL, when nonempty, is compared
-// exactly with the resolved effective push URL before validation; a mismatch
-// returns ErrUnexpectedPushURL. It then calls AdditionalChecks when supplied.
+// does not execute target binaries. The selected formatting, distribution,
+// file-size, and Markdown checks then run before AdditionalChecks. Markdown is
+// disabled when nil and enabled by a non-nil specification; outside-checkout
+// destinations are reported as out of scope unless boundary enforcement is
+// selected. Submodule contents remain out of scope. ExpectedPushURL, when
+// nonempty, is compared exactly with the resolved effective push URL before
+// validation; a mismatch returns ErrUnexpectedPushURL. It then calls
+// AdditionalChecks when supplied.
 // It optionally builds selected targets in temporary storage outside the
 // worktree and pushes the exact annotated tag object to the selected remote.
 // It returns a result with errors: preflight failures are not_attempted, failed