docs: add comprehensive API comparison guide}
* Create COMPARISON.md with detailed API feature comparison
* Document differences between implementations and use cases
* Add reference to COMPARISON.md in README.md
* Include comparison table for quick feature lookup