Skip to content

feat(docs): refine messaging to emphasize Lambda-first design#228

Merged
j-d-ha merged 2 commits into
mainfrom
chore/update-docs
Dec 11, 2025
Merged

feat(docs): refine messaging to emphasize Lambda-first design#228
j-d-ha merged 2 commits into
mainfrom
chore/update-docs

Conversation

@j-d-ha

@j-d-ha j-d-ha commented Dec 11, 2025

Copy link
Copy Markdown
Collaborator

🚀 Pull Request

📋 Summary

Refines documentation across README, docs site, and package README to better communicate MinimalLambda's value proposition. The updated messaging emphasizes that MinimalLambda is Lambda-first hosting with Minimal API-inspired patterns, rather than positioning it as "ASP.NET Core for Lambda."

Key changes:

  • Updates taglines to highlight "Lambda-first" approach with "Minimal API-inspired patterns"
  • Clarifies that MinimalLambda is purpose-built for Lambda's execution model (strongly-typed envelopes, lifecycle hooks, scoped invocations) while using familiar .NET patterns
  • Refines overview sections to emphasize Lambda-specific features alongside familiar DI/middleware/builder patterns
  • Removes direct ASP.NET Core comparison table that suggested it was a 1:1 port

The new messaging better reflects that MinimalLambda adapts familiar patterns to Lambda's unique execution model rather than simply translating ASP.NET Core to Lambda.


✅ Checklist

  • My changes build cleanly
  • I've added/updated relevant tests
  • I've added/updated documentation or README
  • I've followed the coding style for this project
  • I've tested the changes locally (if applicable)

🧪 Related Issues or PRs

N/A - Documentation refinement


💬 Notes for Reviewers

This is purely messaging/positioning changes - no code or functionality changes. The goal is to set clearer expectations that MinimalLambda is Lambda-first (not ASP.NET Core adapted for Lambda) while maintaining the "familiar patterns" value proposition.

- Updated index and README files to highlight Lambda-first design and minimal API-inspired patterns.
- Enhanced description of key features, including envelopes, lifecycle hooks, and source generation.
- Improved AOT readiness and dependency injection explanations for clarity.
- Refined messaging to emphasize Lambda-optimized runtime and familiar .NET ergonomics.
- Refined wording to clearly emphasize the framework's type-safe and scoped invocation capabilities.
- Enhanced messaging around predictable timeouts and smoother developer experience.
- Added details on Lambda's execution model alignment for better clarity.
@github-actions github-actions Bot added the type: feat New feature label Dec 11, 2025
@j-d-ha
j-d-ha merged commit e877f28 into main Dec 11, 2025
6 checks passed
@j-d-ha
j-d-ha deleted the chore/update-docs branch December 11, 2025 19:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: feat New feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant