Update Documentation and Usage Examples

[aamironline]

Expand package documentation to clearly state concurrency guarantees, thread-safety expectations, and best practices for using signals in concurrent programs. Add more usage examples, especially for advanced or concurrent scenarios.

Reasoning

Clear documentation helps users avoid misuse and understand the guarantees provided by the library, reducing the risk of subtle bugs in production.

Test Passing Criteria

1. Package documentation clearly states concurrency guarantees, thread-safety expectations, and best practices for concurrent use.
2. Usage examples are updated and expanded, including advanced and concurrent scenarios.
3. Documentation is reviewed for clarity and completeness.
4. All code examples in the documentation are tested and compile without errors.