-
Notifications
You must be signed in to change notification settings - Fork 27
blog post: announcing the aep-2026 release #394
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 6 commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
effba18
blog post: announcing the aep-2026 release
earth2marsh 68f3113
adds image for aep-2026 blog post
earth2marsh a7cdbf3
Update blog/aep-2026-release.mdx
earth2marsh cf329f1
addressing suggested fixes
earth2marsh f756386
linking directly to the MCP server project
earth2marsh 8c9b8b1
should address linting errors?
earth2marsh 2e4abe4
Apply suggestions from code review
earth2marsh f49c52d
Extension -> Enhancement
earth2marsh 780606b
fixed linting issues
earth2marsh File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,96 @@ | ||
| --- | ||
| title: Announcing the aep-2026 Release | ||
| date: 2025-12-08 | ||
| authors: | ||
| - name: Marsh Gardiner | ||
| - name: Yusuke Tsutsumi | ||
| - name: Alex Stephen | ||
| --- | ||
|
|
||
| import { Image } from 'astro:assets'; | ||
| import aep300Image from './aep_300_image.png'; | ||
|
|
||
| # The Coordination Challenge | ||
|
|
||
| Building software is a team sport, but keeping everyone on the same page is | ||
| hard. When every team has to invent their own API patterns — deciding how | ||
| pagination works, or how to format errors — we end up with a lot of wasted | ||
| effort and systems that don't quite fit together. This isn't just about having | ||
| "standards". It's about ensuring that users and tools don't have to | ||
| continuously relearn the same standards. | ||
|
|
||
| # A Shared Standard and Tools | ||
|
|
||
| The aep-2026 edition is our answer to that friction. It is an opinionated API | ||
| design specification, providing well-defined requirements around common REST | ||
| concepts like CRUD standard methods, pagination, filtering, and more. By | ||
| agreeing on these common patterns, we make it easier for services to talk to | ||
| each other and for developers to move between projects without needing to learn | ||
| idiosyncratic conventions. | ||
|
|
||
| <Image | ||
| src={aep300Image} | ||
| alt="Screenshot of the AEP-300 rule describing edition-based versioning" | ||
| /> | ||
|
|
||
| AEP is an open-source, "anti-bike shedding" kit. It answers the routine | ||
earth2marsh marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| questions so we can all focus on the interesting ones. It’s about a shared | ||
| foundation that lifts everyone up and lets everyone build on the same tooling | ||
| platform. | ||
|
|
||
| # Stability for Builders | ||
|
|
||
| To build lasting tools, you need a solid foundation. You can't build tooling on | ||
| top of a spec that changes regularly. The aep-2026 edition is a major milestone | ||
| because we are freezing the core specification and establishing a release | ||
| cadence with [AEP-300](https://aep.dev/300/). This creates a stable platform | ||
| for the community: | ||
earth2marsh marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| - **For Builders:** Invest in linters, libraries, and other | ||
| [tools](https://aep.dev/tooling-and-ecosystem/#tools) today knowing they will | ||
| keep working for years. | ||
| - **For the Future:** We can keep discussing new improvements for the next | ||
| edition (AEP-2028) without breaking the tools you rely on right now. | ||
|
|
||
| The tooling is guaranteed to be compatible for the three most | ||
| [recent editions of AEPs](https://aep.dev/300/#first-party-clients-and-tooling), | ||
| effectively a **6 year stability cycle** based on our current 2-year cadence. | ||
|
|
||
| # The Tooling Ecosystem | ||
|
|
||
| Because the standard is now stable, we can share a set of tools that help | ||
| everyone do less grunt work. The 2026 edition launches with a compatible | ||
| ecosystem ready for you to use: | ||
|
|
||
| - **Infrastructure:** A | ||
| [Terraform Provider](https://github.com/aep-dev/terraform-provider-aep) to | ||
| handle the deployment details. | ||
| - **Integration:** An [MCP Server](https://github.com/aep-dev/aep-mcp-server) | ||
| to let AI agents understand your APIs out of the box. | ||
| - **Exploration:** An [Interactive Web UI](http://ui.aep.dev) to make daily | ||
| development smoother. | ||
| - **Speed:** A [CLI](https://github.com/aep-dev/aepcli) to quickly call an | ||
| AEP-compatible service. | ||
|
|
||
| # Next Steps | ||
|
|
||
| Come see what we’ve built. Whether you use the whole platform or just grab a | ||
| few good ideas, you are welcome here. | ||
|
|
||
| - **Explore:** Check out the | ||
| [Tools Page](https://aep.dev/tooling-and-ecosystem/#tools) to see what's | ||
| available or visit the [aep.dev](http://aep.dev) site to review the numbered | ||
| rules. | ||
| - **Join:** Drop into a | ||
| [weekly Friday meeting](https://github.com/aep-dev/aeps/tree/main?tab=readme-ov-file#learn-and-connect) | ||
| or hop into our #aep | ||
| [Slack channel](https://github.com/aep-dev/aeps/tree/main?tab=readme-ov-file#learn-and-connect) | ||
| in the CNCF Slack to ask questions or say hello. | ||
|
|
||
| # Contributors | ||
|
|
||
| This release is the result of years of work and feedback from the community. | ||
| Special thanks to Richard Frankel, Marsh Gardiner, Yusuke Tsutsumi, Alex | ||
| Stephen, and Mike Kistler for their stewardship as maintainers on this release. | ||
| We are also grateful to the growing community of contributors, including David | ||
| Gagne, Olivier Canos, Oscar Söderlund, and others! | ||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.