Comprehensive iOS Documentation Improvements

[Copilot]

This PR significantly improves the iOS documentation for Open Mobile Maps, expanding it from ~640 lines to over 1,300 lines with comprehensive coverage for both beginners and advanced developers.

Key Improvements

📚 Structure & Navigation

• Added complete Table of Contents for easy navigation
• Organized content into logical, progressive sections
• Fixed version inconsistency (Android 6.0+ → 8.0+, OpenGL ES 3.2)

🚀 Quick Start Experience

• Added comprehensive Quick Start section with copy-paste examples
• Separate examples for SwiftUI (iOS 17.0+) and UIKit approaches
• Clear system requirements (iOS 14.0+, Xcode 14.0+, Swift 5.7+)

💎 Code Quality & Safety

• Used concise try! syntax in documentation examples for brevity
• Added guard statements for safe unwrapping where appropriate
• Comprehensive error handling examples in troubleshooting and testing sections

🎥 Advanced Features

• Camera & Gesture Handling: Comprehensive section with reactive SwiftUI bindings, programmatic UIKit control, custom touch handlers, and gesture customization
• Performance Considerations: Best practices for layer management, memory optimization, thread safety, and offline support
• Advanced Customization: Coordinate systems, custom tile loading, accessibility support, and theming

🔧 Developer Support

• Troubleshooting Section: Common build/runtime issues with solutions
• Testing & Debugging: Unit testing, integration testing, performance testing, and custom debugging tools
• Debug logging configuration and performance monitoring

📖 Enhanced Examples

Documentation examples use concise try! syntax to focus on core concepts:

mapView.add(layer: try! VectorLayer("layer", styleURL: url))

Comprehensive error handling is demonstrated in the troubleshooting and testing sections where it serves an educational purpose.

The documentation now provides immediate value for new developers while serving as a comprehensive reference for advanced use cases, including offline capabilities, accessibility support, and performance optimization.

Fixes #853.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Copilot]

@maerki 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

[maerki]

@copilot its ok to use try! in sample code to shorten length of examples. developers will know how to add do-catch

[Copilot]

@copilot its ok to use try! in sample code to shorten length of examples. developers will know how to add do-catch

Reverted to using try! in all example code to keep documentation concise and focused on core concepts. The error handling examples remain in the troubleshooting and testing sections where they serve an educational purpose. Commit d37afbb