v0.36.0 doc sweep update

internal/pipeline/pipeline.go

@@ -1,3 +1,8 @@
+// Package pipeline runs one pipeline: its sources through the flow to its
+// sinks, each plugin made by the factory its type registered. Sinks start
+// before the sources and stop after them, so entries in flight arrive; a full
+// sink drops its event unless it declares core.CapBackpressure. A tap gives a
+// viewer a copy of what the flow decides.
 package pipeline
 
 import (
@@ -39,7 +44,7 @@ type Pipeline struct {
 	cancel       context.CancelFunc
 	wg           sync.WaitGroup
 	running      atomic.Bool
-	halt         chan struct{} // closed by Stop: backpressure sinks drop again
+	halt         chan struct{} // closed by Stop: backpressure events may then drop, room or not
 	finished     chan struct{} // closed when every source has ended
 	finishedOnce sync.Once
 }

internal/pipeline/pipeline_test.go

@@ -143,8 +143,8 @@ func TestStopReleasesStalledBackpressureSink(t *testing.T) {
 }
 
 // The tap gets each entry's verdict under its source's id: the stage that
-// dropped it, or what the sinks got. Drops come only when All is set, and
-// heartbeats come as passed, from no source.
+// dropped it, or what dispatch offered the sinks. Drops come only when All is
+// set, and heartbeats come as passed, from no source.
 func TestTapSeesEachVerdict(t *testing.T) {
 	const n = 1000
 	verdict := func(msg string) (string, int) {