Doc: adding backpressure and scheduling documentation + adding Serialize operator

[samber]

No description provided.

[claude]

Summary

This PR adds comprehensive documentation for backpressure and scheduling concepts, as well as a new Serialize operator. The documentation is well-written and provides excellent coverage of important reactive programming concepts.

Issues Found

Critical Issues

• Missing tests: The Serialize operator lacks unit tests, which is required by the contribution guidelines
• Missing Go Playground example: The operator needs a playground link in the source code comment

Documentation Issues

• Missing imports: The Serialize example is missing fmt and time package imports
• Empty playUrl: The documentation frontmatter has an empty playUrl field
• Typos: Several typos in the backpressure documentation (NewEventualySafeObservable should be NewEventuallySafeObservable)
• Incorrect cross-reference: SubscribeOn documentation refers to itself instead of ObserveOn

Recommendations

1. Add tests for the Serialize operator to verify thread-safety behavior
2. Add Go Playground example in the source code comment
3. Fix missing imports in the documentation example
4. Fix typos in the backpressure documentation
5. Add playground URL or remove the field if not possible yet

Code Quality

The Serialize operator implementation is simple and correct - it properly wraps observables in a SafeObservable for thread safety. The extensive documentation additions are valuable and well-structured, providing excellent guidance on backpressure and scheduling concepts.

No breaking changes or security issues identified.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 0% with 6 lines in your changes missing coverage. Please review.
✅ Project coverage is 67.83%. Comparing base (d0f2737) to head (3f07e1f).

Files with missing lines	Patch %	Lines
operator_utility.go	0.00%	6 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #168      +/-   ##
==========================================
- Coverage   67.88%   67.83%   -0.05%     
==========================================
  Files          76       76              
  Lines        8355     8361       +6     
==========================================
  Hits         5672     5672              
- Misses       2598     2604       +6     
  Partials       85       85              

Flag	Coverage Δ
unittests	67.83% <0.00%> (-0.05%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[claude]

Great additions to the documentation! The backpressure and scheduling guides are comprehensive and well-written. However, I have a few concerns about the Serialize operator implementation:

Issues to address:

1. Missing tests: The Serialize operator needs comprehensive test coverage including concurrency scenarios, context cancellation, and edge cases as mentioned in the contributing guidelines.

2. Context handling: There's a potential issue with context propagation in the Serialize implementation - the context isn't being properly passed through.

3. Documentation gaps:

   • Missing Go Playground URL for the Serialize operator
   • Examples could better demonstrate the race conditions that Serialize prevents

4. Example inconsistency: The backpressure documentation shows concurrent emissions that may not preserve order, but the expected output suggests sequential ordering.

The documentation additions are excellent and will be very valuable for users. Once the Serialize operator has proper test coverage and the minor issues are addressed, this will be ready to merge.

Would you consider adding the missing tests for Serialize?