Generate comprehensive documentation suite for fantasy football chat bot

[Copilot]

This PR addresses the issue "Generate or update documentation" by creating a comprehensive documentation suite that transforms the project from having basic usage instructions to professional, maintainable documentation.

What's Changed

New Documentation Files Created

• docs/API_REFERENCE.md - Complete API documentation for all modules, classes, and functions with parameters, return values, and usage examples
• docs/ARCHITECTURE.md - Internal architecture overview explaining system design, component interactions, data flow, and technical implementation details
• docs/DEVELOPER_GUIDE.md - Comprehensive development setup guide with environment configuration, testing strategies, debugging tips, and feature addition instructions
• docs/MESSAGE_SCHEDULE.md - Detailed weekly message schedule showing when each message type is sent, timing explanations, and configuration impact
• docs/ENVIRONMENT_VARIABLES.md - Complete configuration reference with examples for all deployment scenarios (Heroku, Docker, local development)
• docs/README.md - Documentation index providing organized navigation and quick reference
• CONTRIBUTING.md - Development workflow, coding standards, pull request process, and community guidelines
• CHANGELOG.md - Version history tracking and release management guidelines

Enhanced Existing Documentation

• Updated README.md with links to new documentation sections and improved table of contents
• Enhanced function docstrings in gamedaybot/espn/env_vars.py and gamedaybot/espn/scheduler.py with detailed parameter descriptions following NumPy documentation standards

Key Features

Multi-Audience Documentation

• Users: Setup guides, configuration reference, message scheduling
• Developers: API reference, architecture overview, development workflow
• Contributors: Contributing guidelines, coding standards, testing requirements

Professional Standards

• Consistent Markdown formatting across all documents
• Cross-references between related documentation
• Code examples and practical usage patterns
• Visual organization with tables and structured information
• Industry-standard documentation practices

Comprehensive Coverage

• Complete API documentation for all 20+ functions and classes
• System architecture with component diagrams and data flow explanations
• Weekly message schedule with timing details and configuration options
• Environment variable reference with examples for all deployment scenarios
• Step-by-step development setup and contribution workflow

Technical Quality

• All tests pass (65/65) - no breaking changes introduced
• Enhanced code documentation with detailed docstrings following NumPy standards
• Backward compatibility maintained throughout documentation updates
• Future-proof structure supporting ongoing maintenance and community growth

Impact

This documentation suite provides:

• Improved onboarding for new users and developers
• Reduced support burden with comprehensive troubleshooting guides
• Enhanced maintainability with clear architecture documentation
• Community growth support with contributor-friendly guidelines
• Professional project presentation suitable for broader adoption

The documentation follows industry best practices and transforms the project into a well-documented, community-ready open source project.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.