Skip to content

Commit ea43772

Browse files
phipagphipag
committed
Add roadmap.
1 parent 678cd5f commit ea43772

File tree

2 files changed

+149
-0
lines changed

2 files changed

+149
-0
lines changed

‎docs/roadmap.md

Lines changed: 141 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,141 @@
1+
---
2+
title: Roadmap
3+
description: Public roadmap for Powertools for AWS Lambda (Java)
4+
---
5+
6+
## Overview
7+
8+
Our public roadmap outlines the high level direction we are working towards. We update this document when our priorities change: security and stability are our top priority.
9+
10+
### Key areas
11+
12+
Security and operational excellence take precedence above all else. This means bug fixing, stability, customer's support, and internal compliance may delay one or more key areas below.
13+
14+
!!! info "We may choose to re-prioritize or defer items based on customer feedback, security, and operational impacts, and business value."
15+
16+
#### Release Security (p0)
17+
18+
Our top priority is to establish the processes and infrastructure needed for a fully automated and secure end-to-end release process of new versions to Maven Central.
19+
20+
- [ ] Implement GitHub workflows and create infrastructure to release to Maven Central
21+
- [x] [Implement end-to-end tests](https://github.com/aws-powertools/powertools-lambda-java/issues/1815){target="\_blank"}
22+
- [x] Implement [OpenSSF Scorecard](https://openssf.org/projects/scorecard/){target="\_blank"}
23+
24+
#### `v2` Release: Consistency and Ecosystem (p1)
25+
26+
As part of a new major version `v2` release, we prioritize the Java project's consistency of core utilities (Logging, Metrics, Tracing) with the other runtimes (Python, TypeScript, .NET). Additionally, we will focus on integrating the library with popular technologies and frameworks from the Java and AWS ecosystem. Particularly, we aim at leveraging new techniques to allow customers to reduce Lambda cold-start time. The `v2` release will also drop support for Java 8 moving to Java 11 as the baseline.
27+
28+
##### Core Utilities
29+
30+
- [ ] [Review public interfaces and reduce public API surface area](https://github.com/aws-powertools/powertools-lambda-java/issues/1283){target="\_blank"}
31+
- [x] [Release Logging `v2` module](https://github.com/aws-powertools/powertools-lambda-java/issues/965){target="\_blank"} allowing customers to choose the logging framework and adding support for logging deeply nested objects as JSON
32+
- [x] [Support high resolution metrics](https://github.com/aws-powertools/powertools-lambda-java/issues/1041){target="\_blank"}
33+
34+
##### Ecosystem
35+
36+
- [x] [Add GraalVM support for core utilities](https://github.com/aws-powertools/powertools-lambda-java/issues/764){target="\_blank"}
37+
- [ ] [Implement priming using CRaC to improve AWS Snapstart support](https://github.com/aws-powertools/powertools-lambda-java/issues/1588){target="\_blank"}
38+
- [ ] [Evaluate integration with popular Java frameworks such as Micronaut, Spring Cloud Function, or Quarkus](https://github.com/aws-powertools/powertools-lambda-java/issues/1701){target="\_blank"}
39+
40+
##### Other
41+
42+
- [x] [Validation module integration with HTTP requests](https://github.com/aws-powertools/powertools-lambda-java/issues/1298){target="\_blank"}
43+
- [x] [Support validation module from within the batch module](https://github.com/aws-powertools/powertools-lambda-java/issues/1496){target="\_blank"}
44+
- [x] [Add support for parallel processing in Batch Processing utility](https://github.com/aws-powertools/powertools-lambda-java/issues/1540){target="\_blank"}
45+
- [ ] [Documentation: Review and improve documentation to be consistent with other runtimes](https://github.com/aws-powertools/powertools-lambda-java/issues/1352){target="\_blank"}
46+
47+
#### Feature Parity (p2)
48+
49+
If priorities `p0` and `p1` are addressed, we will also focus on feature parity of non-core utilities. This allows customers to achieve better standardization of their development processes across different Powertools runtimes.
50+
51+
- [ ] [Re-evaluate if there is a need for adding a lightweight customer Powertools event handler](https://github.com/aws-powertools/powertools-lambda-java/issues/1103){target="\_blank"}
52+
- [ ] [Add comprehensive GraalVM support for all utilities](){target="\_blank"}
53+
- [ ] [Add Feature Flags module](https://github.com/aws-powertools/powertools-lambda-java/issues/1086){target="\_blank"}
54+
- [ ] [Add S3 Streaming module](https://github.com/aws-powertools/powertools-lambda-java/issues/1085){target="\_blank"}
55+
- [ ] Add support for Data Masking during JSON serialization
56+
57+
### Missing something?
58+
59+
You can help us prioritize by [upvoting existing feature requests](https://github.com/aws-powertools/powertools-lambda-java/issues?q=is%3Aissue%20state%3Aopen%20label%3Aenhancement){target="\_blank"},
60+
leaving a comment on what use cases it could unblock for you, and by joining our discussions on Discord.
61+
62+
[![Join our Discord](https://dcbadge.vercel.app/api/server/B8zZKbbyET)](https://discord.gg/B8zZKbbyET){target="\_blank"}
63+
64+
### Roadmap status definition
65+
66+
<center>
67+
```mermaid
68+
graph LR
69+
Ideas --> Backlog --> Work["Working on it"] --> Merged["Coming soon"] --> Shipped
70+
```
71+
<i>Visual representation</i>
72+
</center>
73+
74+
Within our [public board](https://github.com/orgs/aws-powertools/projects/4/){target="\_blank"}, you'll see the following values in the `Status` column:
75+
76+
- **Ideas**. Incoming and existing feature requests that are not being actively considered yet. These will be reviewed
77+
when bandwidth permits.
78+
- **Backlog**. Accepted feature requests or enhancements that we want to work on.
79+
- **Working on it**. Features or enhancements we're currently either researching or implementing it.
80+
- **Coming soon**. Any feature, enhancement, or bug fixes that have been merged and are coming in the next release.
81+
- **Shipped**. Features or enhancements that are now available in the most recent release.
82+
83+
> Tasks or issues with empty `Status` will be categorized in upcoming review cycles.
84+
85+
### Process
86+
87+
<center>
88+
```mermaid
89+
graph LR
90+
PFR[Feature request] --> Triage{Need RFC?}
91+
Triage --> |Complex/major change or new utility?| RFC[Ask or write RFC] --> Approval{Approved?}
92+
Triage --> |Minor feature or enhancement?| NoRFC[No RFC required] --> Approval
93+
Approval --> |Yes| Backlog
94+
Approval --> |No | Reject["Inform next steps"]
95+
Backlog --> |Prioritized| Implementation
96+
Backlog --> |Defer| WelcomeContributions["help-wanted label"]
97+
```
98+
<i>Visual representation</i>
99+
</center>
100+
101+
Our end-to-end mechanism follows four major steps:
102+
103+
- **Feature Request**. Ideas start with a [feature request](https://github.com/aws-powertools/powertools-lambda-java/issues/new?template=feature_request.md){target="\_blank"} to outline their use case at a high level. For complex use cases, maintainers might ask for/write a
104+
RFC.
105+
- Maintainers review requests based on [project tenets](index.md#tenets){target="\_blank"}, customers reaction (👍),
106+
and use cases.
107+
- **Request-for-comments (RFC)**. Design proposals use
108+
our [RFC template](https://github.com/aws-powertools/powertools-lambda-java/issues/new?q=is%3Aissue+state%3Aopen+label%3Aenhancement&template=rfc.md){target="\_blank"} to describe its implementation, challenges, developer experience, dependencies, and alternative solutions.
109+
- This helps refine the initial idea with community feedback before a decision is made.
110+
- **Decision**. After carefully reviewing and discussing them, maintainers make a final decision on whether to start
111+
implementation, defer or reject it, and update everyone with the next steps.
112+
- **Implementation**. For approved features, maintainers give priority to the original authors for implementation unless
113+
it is a sensitive task that is best handled by maintainers.
114+
115+
!!! info "See [Maintainers](./processes/maintainers.md){target="\_blank"} document to understand how we triage issues and pull requests, labels and governance."
116+
117+
### Disclaimer
118+
119+
The Powertools for AWS Lambda (Java) team values feedback and guidance from its community of users, although final
120+
decisions on inclusion into the project will be made by AWS.
121+
122+
We determine the high-level direction for our open roadmap based on customer feedback and popularity (👍🏽 and comments),
123+
security and operational impacts, and business value. Where features don’t meet our goals and longer-term strategy, we
124+
will communicate that clearly and openly as quickly as possible with an explanation of why the decision was made.
125+
126+
### FAQs
127+
128+
**Q: Why did you build this?**
129+
130+
A: We know that our customers are making decisions and plans based on what we are developing, and we want to provide our
131+
customers the insights they need to plan.
132+
133+
**Q: Why are there no dates on your roadmap?**
134+
135+
A: Because job zero is security and operational stability, we can't provide specific target dates for features. The
136+
roadmap is subject to change at any time, and roadmap issues in this repository do not guarantee a feature will be
137+
launched as proposed.
138+
139+
**Q: How can I provide feedback or ask for more information?**
140+
141+
A: For existing features, you can directly comment on issues. For anything else, please open an issue.

‎mkdocs.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ nav:
66
- Homepage: index.md
77
- Changelog: changelog.md
88
- FAQs: FAQs.md
9+
- Roadmap: roadmap.md
910
- Core utilities:
1011
- core/logging.md
1112
- core/tracing.md
@@ -59,6 +60,8 @@ markdown_extensions:
5960
- pymdownx.snippets:
6061
base_path: "."
6162
check_paths: true
63+
- pymdownx.tasklist:
64+
custom_checkbox: true
6265
- pymdownx.superfences:
6366
custom_fences:
6467
- name: mermaid
@@ -81,6 +84,11 @@ plugins:
8184
markdown_description: Powertools for AWS Lambda (Java) is a developer toolkit to implement Serverless best practices and increase developer velocity. It provides a suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray, structured logging and creating custom metrics asynchronously easier.
8285
full_output: llms-full.txt
8386
sections:
87+
Project Overview:
88+
- index.md
89+
- changelog.md
90+
- FAQs.md
91+
- roadmap.md
8492
Core Utilities:
8593
- core/logging.md
8694
- core/metrics.md

0 commit comments

Comments
 (0)