chore(docs): add docstring explaining streaming pattern (#205)

Author: stainless-app[bot]

packages/ssestream/ssestream.go

@@ -131,6 +131,17 @@ func NewStream[T any](decoder Decoder, err error) *Stream[T] {
 	}
 }
 
+// Next returns false if the stream has ended or an error occurred.
+// Call Stream.Current() to get the current value.
+// Call Stream.Err() to get the error.
+//
+//		for stream.Next() {
+//			data := stream.Current()
+//		}
+//
+//	 	if stream.Err() != nil {
+//			...
+//	 	}
 func (s *Stream[T]) Next() bool {
 	if s.err != nil {
 		return false