Skip to content

Commit 13f6e01

Browse files
authored
docs(roadmap): add new roadmap section (aws-powertools#1204)
1 parent 1ca74d3 commit 13f6e01

File tree

3 files changed

+106
-4
lines changed

3 files changed

+106
-4
lines changed

README.md

+6-2
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
# AWS Lambda Powertools (Python)
1+
# AWS Lambda Powertools for Python
22

33
![Build](https://github.com/awslabs/aws-lambda-powertools/workflows/Powertools%20Python/badge.svg?branch=master)
44
[![codecov.io](https://codecov.io/github/awslabs/aws-lambda-powertools-python/branch/develop/graphs/badge.svg)](https://app.codecov.io/gh/awslabs/aws-lambda-powertools-python)
55
![PythonSupport](https://img.shields.io/static/v1?label=python&message=3.6%20|%203.7|%203.8|%203.9&color=blue?style=flat-square&logo=python) ![PyPI version](https://badge.fury.io/py/aws-lambda-powertools.svg) ![PyPi monthly downloads](https://img.shields.io/pypi/dm/aws-lambda-powertools)
66

77
A suite of Python utilities for AWS Lambda functions to ease adopting best practices such as tracing, structured logging, custom metrics, and more. (AWS Lambda Powertools [Java](https://github.com/awslabs/aws-lambda-powertools-java) and [Typescript](https://github.com/awslabs/aws-lambda-powertools-typescript) is also available).
88

9-
**[📜Documentation](https://awslabs.github.io/aws-lambda-powertools-python/)** | **[🐍PyPi](https://pypi.org/project/aws-lambda-powertools/)** | **[Roadmap](https://github.com/awslabs/aws-lambda-powertools-roadmap/projects/1)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-lambda-powertools/)**
9+
**[📜Documentation](https://awslabs.github.io/aws-lambda-powertools-python/)** | **[🐍PyPi](https://pypi.org/project/aws-lambda-powertools/)** | **[Roadmap](https://awslabs.github.io/aws-lambda-powertools-python/latest/roadmap/)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-lambda-powertools/)**
1010

1111
> **An AWS Developer Acceleration (DevAx) initiative by Specialist Solution Architects | [email protected]**
1212
@@ -51,6 +51,10 @@ With [pip](https://pip.pypa.io/en/latest/index.html) installed, run: ``pip insta
5151
* **AWS Developers Slack**: `#lambda-powertools` - **[Invite, if you don't have an account](https://join.slack.com/t/awsdevelopers/shared_invite/zt-yryddays-C9fkWrmguDv0h2EEDzCqvw)**
5252
* **Email**: [email protected]
5353

54+
## Security disclosures
55+
56+
If you think you’ve found a potential security issue, please do not post it in the Issues. Instead, please follow the instructions [here](https://aws.amazon.com/security/vulnerability-reporting/) or [email AWS security directly](mailto:[email protected]).
57+
5458
## License
5559

5660
This library is licensed under the MIT-0 License. See the LICENSE file.

docs/roadmap.md

+99
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
## Overview
2+
3+
???+ info "We are currently paused for new features [until end of July 2022](https://github.com/awslabs/aws-lambda-powertools-python/issues/1009){target="_blank"}."
4+
5+
This is our public roadmap that outlines the high level direction we are working towards, namely [Themes](#themes). We update this document on a periodic basis to reflect any changing priorities - Security and stability is our top priority.
6+
7+
[See our latest list of activities »](https://github.com/orgs/awslabs/projects/51/views/1?query=is%3Aopen+sort%3Aupdated-desc){target="_blank"}
8+
9+
## Themes
10+
11+
Themes are key activities maintainers are focusing on, besides bug reports. These are updated periodically and you can find the latest [under Epics in our public board](https://github.com/orgs/awslabs/projects/51/views/11?query=is%3Aopen+sort%3Aupdated-desc){target="_blank"}.
12+
13+
### Lambda Layers migration
14+
15+
We are migrating our Lambda Layers internal release pipeline towards an AWS CodePipeline based system. This will allow us to more rapidly adopt additional regions, custom builds, and decrease our rollout time to all commercial regions.
16+
17+
### End-to-end testing
18+
19+
We are working on a framework to selectively run end-to-end tests as part of Pull Requests and upon merge. This will increase our confidence in detecting regressions early, and also explore ideas for utilities that can make testing easier for customers.
20+
21+
### Python 3.6 deprecation
22+
23+
We will remove support for Python 3.6 after July 18th, following AWS Lambda [deprecation notice for Python 3.6 runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy){target="_blank"}. We will monitor the deprecation notice in the event of any extension.
24+
25+
### Reduce release operational overhead
26+
27+
We are working on a consistent label and automation strategy across all Lambda Powertools projects ([Java](https://awslabs.github.io/aws-lambda-powertools-java/){target="_blank"}, [TypeScript](https://awslabs.github.io/aws-lambda-powertools-typescript/latest/){target="_blank"}). This will be our baseline to automate areas where we don't need human intervention, and reduce our manual effort to areas where clear communication is crucial.
28+
29+
### Revamp roadmap
30+
31+
We are beta testing the [new GitHub Projects Beta](https://github.com/orgs/awslabs/projects/51/views/1?query=is%3Aopen+sort%3Aupdated-desc){target="_blank"} to provide more visibility on our current activities. This also includes new GitHub Issue Forms Beta to streamline feature requests, bug reports, RFCs, etc., including a new mechanism to add external links like `Ask a Question`.
32+
33+
Once complete, we will repurpose our [central roadmap repository](https://github.com/awslabs/aws-lambda-powertools-roadmap){target="_blank"} to provide a landing page for all Powertools languages, including an experiment to better highlight feature parity across them.
34+
35+
## Roadmap status definition
36+
37+
<center>
38+
```mermaid
39+
graph LR
40+
Ideas --> Backlog --> Work["Working on it"] --> Merged["Coming soon"] --> Shipped
41+
```
42+
<i>Visual representation</i>
43+
</center>
44+
45+
Within our [public board](https://github.com/orgs/awslabs/projects/51/views/1?query=is%3Aopen+sort%3Aupdated-desc){target="_blank"}, you'll see the following values in the `Status` column:
46+
47+
* **Ideas**. Incoming and existing feature requests that are not being actively considered yet. These will be reviewed when bandwidth permits.
48+
* **Backlog**. Accepted feature requests or enhancements that we want to work on.
49+
* **Working on it**. Features or enhancements we're currently either researching or implementing it.
50+
* **Coming soon**. Any feature, enhancement, or bug fixes that have been merged and are coming in the next release.
51+
* **Shipped**. Features or enhancements that are now available in the most recent release.
52+
53+
> Tasks or issues with empty `Status` will be categorized in upcoming review cycles.
54+
55+
## Process
56+
57+
<center>
58+
```mermaid
59+
graph LR
60+
PFR[Feature request] --> Triage{Need RFC?}
61+
Triage --> |Complex/major change or new utility?| RFC[Ask or write RFC] --> Approval{Approved?}
62+
Triage --> |Minor feature or enhancement?| NoRFC[No RFC required] --> Approval
63+
Approval --> |Yes| Backlog
64+
Approval --> |No | Reject["Inform next steps"]
65+
Backlog --> |Prioritized| Implementation
66+
Backlog --> |Defer| WelcomeContributions["help-wanted label"]
67+
```
68+
<i>Visual representation</i>
69+
</center>
70+
71+
Our end-to-end mechanism follows four major steps:
72+
73+
* **Feature Request**. Ideas start with a [feature request issue template](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=feature-request%2Ctriage&template=feature_request.yml&title=Feature+request%3A+TITLE){target="_blank"} to highlight their use case at a high level. Maintainers review each request based on the **(1)** [project tenets](index.md#tenets){target="_blank"}, **(2)** customers reaction (👍) and use cases, and comment whether we'll need a RFC for further discussion before any work begins.
74+
* **Request-for-comments (RFC)**. Design proposals use our [RFC issue template](https://github.com/awslabs/aws-lambda-powertools-python/issues/new?assignees=&labels=RFC%2Ctriage&template=rfc.yml&title=RFC%3A+TITLE){target="_blank"} to describe its implementation, challenges, developer experience, dependencies, and alternative solutions. This helps refine the initial idea with community feedback before a decision is made.
75+
* **Decision**. After carefully reviewing and discussing them, maintainers make a final decision on whether to start implementation, defer or reject it, and update everyone with the next steps.
76+
* **Implementation**. For approved features, maintainers will build a prototype and invite customers for feedback in the original request. Alternatively, maintainers will proactively use the [help wanted](https://github.com/awslabs/aws-lambda-powertools-python/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22help+wanted%22){target="_blank"} tag to signal contributions are welcome to accelerate development.
77+
* **Implementation**. For approved features, maintainers will build a prototype for early feedback, or use [`help wanted`](https://github.com/awslabs/aws-lambda-powertools-python/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22help+wanted%22){target="_blank"} label welcoming contributions to accelerate development.
78+
79+
???+ info "Bug reports, documentation improvements, etc. are not covered by this process. See Maintainers process instead (coming soon)."
80+
81+
82+
## Disclaimer
83+
84+
The AWS Lambda Powertools team values feedback and guidance from its community of users, although final decisions on inclusion into the project will be made by AWS. We determine the high-level direction for our open roadmap based on customer feedback and popularity (👍🏽 and comments), security and operational impacts, and business value. Where features don’t meet our goals and longer-term strategy, we will communicate that clearly and openly as quickly as possible with an explanation of why the decision was made.
85+
86+
87+
## FAQs
88+
89+
**Q: Why did you build this?**
90+
91+
A: We know that our customers are making decisions and plans based on what we are developing, and we want to provide our customers the insights they need to plan.
92+
93+
**Q: Why are there no dates on your roadmap?**
94+
95+
A: Because job zero is security and operational stability, we can't provide specific target dates for features. The roadmap is subject to change at any time, and roadmap issues in this repository do not guarantee a feature will be launched as proposed.
96+
97+
**Q: How can I provide feedback or ask for more information?**
98+
99+
A: For existing features, you can directly comment on issues. For anything else, please open an issue.

mkdocs.yml

+1-2
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ nav:
88
- Homepage: index.md
99
- Changelog: changelog.md
1010
- Tutorial: tutorial/index.md
11-
- Roadmap: https://github.com/awslabs/aws-lambda-powertools-roadmap/projects/1" target="_blank
11+
- Roadmap: roadmap.md
1212
- API reference: api/" target="_blank
1313
- Core utilities:
1414
- core/tracer.md
@@ -99,4 +99,3 @@ extra:
9999
version:
100100
provider: mike
101101
default: latest
102-

0 commit comments

Comments
 (0)