DOC-832: Improve readability and clarity of Active-Active failover documentation

- Restructured content with clear overview and prerequisites
- Added comprehensive code examples with proper labeling
- Improved section organization and flow
- Enhanced explanations of failure detection strategies
- Added troubleshooting section for common issues
- Included practical implementation guidance
- Better formatting with tips, warnings, and notes

Author: mich-elle-luna