docs: add GitHub Pages landing page with MkDocs

[j-d-ha]

Summary

Implements a comprehensive landing page for the aws-lambda-host documentation site using MkDocs with Material theme. This PR adds the foundational documentation infrastructure and a compelling landing page that showcases the framework's value proposition.

Key Changes

Documentation Infrastructure

• Initialize MkDocs with Material theme configuration
• Configure markdown extensions for enhanced formatting (content tabs, admonitions, code highlighting, Material icons)
• Set up GitHub Pages deployment workflow
• Add light/dark mode toggle support

Landing Page Content (docs/index.md)

• Hero Section: Clear value proposition with build badges and CTA buttons
• Why AwsLambda.Host: Side-by-side comparison of Traditional Lambda vs aws-lambda-host
  • Traditional example shows manual DI scoping, cancellation token creation, and JSON handling (marked with ❌)
  • Modern example shows automatic injection and envelope handling (marked with ✅)
• Key Features: 7 framework features with Material icons and links to documentation
• Quick Start: Installation command and runnable code example
• Packages Overview:
  • Core packages table with NuGet badges and download counts
  • Envelope packages table with descriptions and badges
• Examples & Use Cases: Links to example projects
• Community & Resources: Links to GitHub, changelog, documentation sections

Technical Details

• Material for MkDocs Features Used:

  • Content tabs for code comparisons
  • Admonitions for callouts
  • Material icons for visual hierarchy
  • Styled buttons for CTAs
  • Code highlighting with copy buttons

• Code Example Highlights:

  • Shows realistic API Gateway Lambda handler
  • Demonstrates manual scope creation, service resolution, and cancellation token handling in traditional approach
  • Contrasts with clean, declarative aws-lambda-host approach using envelopes and automatic injection

Documentation Plan

This landing page is Phase 1 of the comprehensive documentation plan stored in .claude/DOCUMENTATION_PLAN.md. Future phases will add:

• Getting Started guide
• Feature guides (middleware, DI, lifecycle)
• Envelope documentation for each package
• API reference
• Advanced topics (AOT, source generators, performance)

Test Plan

• Verify MkDocs builds successfully locally
• Validate markdown syntax (content tabs, admonitions, Material icons)
• Check all internal links resolve correctly
• Verify NuGet badge URLs are correct
• Confirm GitHub Pages deployment works
• Test mobile responsiveness
• Verify light/dark mode toggle

References

• Documentation plan: .claude/DOCUMENTATION_PLAN.md
• Landing page implementation plan: .claude/plans/curious-riding-pudding.md
• MkDocs configuration: mkdocs.yml

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

@@           Coverage Diff           @@
##             main     #203   +/-   ##
=======================================
  Coverage   90.68%   90.68%           
=======================================
  Files         102      102           
  Lines        2233     2233           
  Branches      254      254           
=======================================
  Hits         2025     2025           
  Misses        115      115           
  Partials       93       93           

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4f7feca...161661d. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.