Create mdbook documentation structure with GitHub Pages deployment

[Copilot]

This PR establishes a complete mdbook documentation structure for the Rust Philosopher project, transforming it from a simple README into a comprehensive documentation site with automated GitHub Pages deployment.

What's Added

📚 Documentation Structure

• Welcome page introducing Rust Philosopher as a collection of Rust best practices for human and GenAI consumption
• Reference Material section for in-depth technical content
• Alice Ryhl's "Actors with Tokio" article - complete content inlined from ryhl.io with proper attribution

⚖️ Dual Licensing

Added both MIT and Apache 2.0 licenses as requested:

• LICENSE-MIT - MIT License
• LICENSE-APACHE - Apache 2.0 License

🚀 GitHub Pages Automation

Created .github/workflows/deploy.yml that:

• Builds the mdbook on every push to main branch
• Automatically deploys to GitHub Pages
• Uses mdBook v0.4.40 for consistency
• Handles proper GitHub Pages permissions and deployment

⚙️ Configuration

• book.toml configured with repository metadata, GitHub integration, and edit links
• .gitignore to exclude build artifacts
• Clean, professional theme with navigation sidebar

Technical Implementation

The mdbook structure follows best practices:

src/
├── SUMMARY.md              # Table of contents
├── welcome.md              # Introduction page
└── reference/
    ├── README.md           # Reference section overview
    └── actors-with-tokio.md # Complete Alice Ryhl article

The Alice Ryhl article (385 lines) includes the complete content on building actors with Tokio, featuring:

• Comprehensive examples with syntax-highlighted Rust code
• Discussion of actor patterns, handles, and message passing
• Best practices for error handling and graceful shutdown
• Proper attribution to the original author

Screenshots

The welcome page provides a clear introduction to the project's purpose and organization.

The Alice Ryhl article is beautifully rendered with proper code highlighting and navigation.

Ready for Production

The implementation is complete and tested:

• ✅ Local mdbook build successful
• ✅ All content properly formatted and attributed
• ✅ GitHub Actions workflow configured
• ✅ Dual licensing in place
• ✅ Professional documentation structure

Once merged, GitHub Pages will automatically deploy the documentation, providing a solid foundation for expanding the Rust best practices collection.

---

💡 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.