Skip to content

Docs: Create initial structure to add build recipes documentation #7162

@leandrodamascena

Description

@leandrodamascena

What were you searching in the docs?

Customers are looking for comprehensive guidance on how to package Lambda functions with Powertools for AWS Lambda (Python) using different build tools and dependency managers. Currently, there's no dedicated documentation covering the various approaches and their trade-offs.

Is this related to an existing documentation section?

https://docs.powertools.aws.dev/lambda/python/latest/

How can we improve?

Create new build recipes documentation with:

  • Comprehensive guide covering pip, Poetry, uv, SAM, CDK, and Pants
  • Cross-platform build considerations (macOS/Windows → Linux Lambda runtime)
  • GLIBC compatibility guidance for different Lambda runtimes
  • Performance optimization techniques for cold starts and package size
  • CI/CD integration examples
  • Troubleshooting section for common deployment issues

This will help developers choose the right build approach and avoid common pitfalls when deploying Lambda functions with Powertools for AWS.

Got a suggestion in mind?

No response

Acknowledgment

  • I understand the final update might be different from my proposed suggestion, or refused.

Metadata

Metadata

Labels

documentationImprovements or additions to documentationpending-releaseFix or implementation already in dev waiting to be releasedtriagePending triage from maintainers

Projects

Status

Coming soon

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions