Writing a Comprehensive API Documentation Guide

Help me create comprehensive documentation for a RESTful API for [specific service type]. The documentation should include: 1) An overview explaining the API's purpose and core functionality, 2) Authentication methods and security practices, 3) Base URL structure and environment differences, 4) Detailed endpoint documentation with HTTP methods, request parameters, headers, body examples, response formats, status codes, and error handling, 5) Rate limiting information, 6) Pagination explanation, 7) Versioning approach, and 8) Code examples in at least 3 programming languages. Use clear, concise technical language appropriate for developers while avoiding unnecessary jargon. Include best practices for implementation and common pitfalls to avoid.