Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 70 additions & 0 deletions blog/2025-roadmap.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
---
title: AEP's 2025 Roadmap - Building Momentum
date: 2025-02-07
authors:
- name: Mak Ahmad
- name: Yusuke Tsutsumi
- name: Marsh Gardiner
---

As we begin 2025, we want to share our ambitions for the API Enhancement
Proposals (AEP) project. After a successful 2024 that saw the launch of several
key tools and growing community engagement, our focus for 2025 is on
stabilizing the specification while expanding the ecosystem of tools.

## Specification and Standards

A major milestone for 2025 will be the v0.1 release of the AEP specification.
This represents the culmination of much work to adapt and expand the original
API Improvement Proposals, with particular focus on resource-oriented design
patterns that work across both Protocol Buffers and HTTP APIs. The 0.1 release
will include support for the [standard methods](https://aep.dev/130/),
long-running operations (LRO), and other
[design patterns](https://aep.dev/general/#design-patterns) supported across
our toolchain.

## Tooling Releases

Building on the specification, we will be releasing initial versions of core
tools in 2025:

- A production-ready version of the OpenAPI linter with coverage of the
standard methods, list-related patterns, and LROs of the 0.1 specification
- An enhanced Protocol Buffer linter reflecting the latest AEP guidance
- aepcli with LRO support of the 0.1 specification
- The first official release of our Terraform provider
- A stable release of aep-explorer for visually navigating AEP-compliant APIs

## Community Growth

In May, we plan on giving a talk about aep.dev at
[API Days New York](https://www.apidays.global/new-york/). The video will be
released online for those who would like to view but cannot attend.

Building on the success of our 2024 barn raising, we are planning another
community event after the 0.1 specification release. This will focus on helping
organizations learn about the specification, enabling adoption of our
specification and tools, and onboarding interested contributors to the project.

## Longer-Term Goals

In the second half of 2025, we'll focus on:

- Stabilizing and potentially releasing version 0.1 of aepc, our toolkit for
generating service stubs from resource definitions
- Expanding existing tooling based on real-world usage and feedback
- Expanding and refining guidance

Whether you are building new APIs or working to improve existing ones, 2025
will be an exciting year to get involved with AEPs\! Join us in our mission to
make APIs more consistent and maintainable across many industries.

## Get Involved

Join us:

- On CNCF Slack in the
[\#aep](https://cloud-native.slack.com/archives/C04TX46UCTV) channel
- At our weekly community meetings (Fridays at 11:30am PT)
- Through our documentation at [aep.dev](http://aep.dev)
- On GitHub at [github.com/aep-dev](http://github.com/aep-dev)
1 change: 1 addition & 0 deletions scripts/build.sh
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,6 @@ cd "${SG_DIRECTORY}" || exit
mkdir -p src/content/docs/tooling/linter/rules
mkdir -p src/content/docs/tooling/website
npm install
npx playwright install --with-deps chromium
npm run generate
npm run build