docs: Add golangci-lint v2 support documentation and migration guide #406

[devdattatalele]

📚 Documentation Update: golangci-lint v2 Support and Migration Guide

Fixes: #406

Problem

Users with golangci-lint v2 configurations receive warnings that CodeRabbit doesn't support v2, and the current documentation lacks clarity about:

• Which golangci-lint versions are supported by CodeRabbit
• How to work with v2 configurations
• Migration options for v2 users

Solution

This comprehensive documentation update addresses all aspects of golangci-lint version compatibility:

✅ Added Version Compatibility Section

• Clear warning about v2.x support limitations
• Explicit version support matrix (v1.x ✅, v2.x ❌)
• Proper expectations for users

📖 Comprehensive Migration Guide

• Option 1: Dual configuration setup (recommended)
  • Separate v1 config for CodeRabbit
  • Keep v2 config for CI/CD pipelines
• Option 2: Custom config file path approach
• Step-by-step instructions for both approaches

🔧 Practical Examples

• Complete v1.x configuration example
• CodeRabbit configuration with custom file paths
• Real-world migration scenarios

🐛 Troubleshooting Section

• Common warning explanations
• Configuration debugging steps
• v2 → v1 conversion guidelines

🔗 Corrected Documentation Links

• Fixed links to point to v1.x documentation
• Added related documentation references
• Proper version-specific resource links

Technical Details

• File Updated: docs/tools/golangci-lint.md
• Documentation Format: Enhanced with Docusaurus admonitions for better visibility
• Migration Support: Two distinct approaches for different team workflows
• Backward Compatibility: Existing v1 users unaffected

Impact

• Reduces Support Tickets: Clear guidance eliminates confusion about v2 support
• Enables v2 Users: Provides actionable solutions for teams using modern golangci-lint
• Improves DX: Better developer experience with clear migration paths
• Accurate Information: Corrects misleading documentation links

Testing Recommendations

• Verify examples work with actual golangci-lint v1.x installations
• Test dual configuration setup in real projects
• Validate all documentation links are accessible

This update provides a complete solution for issue #406, giving users clear guidance on golangci-lint version compatibility and practical migration options.