Revert "docs: Remove stale shutdown order comments"

This reverts commit 7360649.

Author: the-mann

plugins/outputs/cloudwatchlogs/cloudwatchlogs.go

@@ -89,12 +89,16 @@ func (c *CloudWatchLogs) Connect() error {
 }
 
 func (c *CloudWatchLogs) Close() error {
-	// Shutdown order:
-	// 1. Stop pushers (queues + senders) — no new batches created
-	// 2. Wait for pushers to complete
-	// 3. Stop RetryHeapProcessor — flush remaining batches, stop sender pool
-	// 4. Stop WorkerPool — no more worker threads
-	// 5. Stop RetryHeap — final cleanup
+	// Stop components in specific order to prevent race conditions:
+	// 1. RetryHeap - stop accepting new batches first
+	// 2. Pushers - stop all active pushers (queues/senders)
+	// 3. Wait for pushers to complete
+	// 4. RetryHeapProcessor - stop retry processing and wait for WorkerPool usage to complete
+	// 5. WorkerPool - finally stop the worker threads
+
+	if c.retryHeap != nil {
+		c.retryHeap.Stop()
+	}
 
 	c.cwDests.Range(func(_, value interface{}) bool {
 		if d, ok := value.(*cwDest); ok {
@@ -113,6 +117,10 @@ func (c *CloudWatchLogs) Close() error {
 		c.workerPool.Stop()
 	}
 
+	if c.retryHeapProcessor != nil {
+		c.retryHeapProcessor.Stop()
+	}
+
 	if c.retryHeap != nil {
 		c.retryHeap.Stop()
 	}